From patchwork Tue Feb 19 21:45:53 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kevin Buettner X-Patchwork-Id: 31528 Received: (qmail 30859 invoked by alias); 19 Feb 2019 21:46:15 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 30338 invoked by uid 89); 19 Feb 2019 21:45:56 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-25.4 required=5.0 tests=BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, KAM_STOCKGEN, SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=Hx-languages-length:1485, value.__init__, value__init__, Mention X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 19 Feb 2019 21:45:55 +0000 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id A4BAE285B3 for ; Tue, 19 Feb 2019 21:45:54 +0000 (UTC) Received: from f29-4.lan (ovpn-117-11.phx2.redhat.com [10.3.117.11]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 630BE17C78 for ; Tue, 19 Feb 2019 21:45:54 +0000 (UTC) Date: Tue, 19 Feb 2019 14:45:53 -0700 From: Kevin Buettner To: gdb-patches@sourceware.org Subject: [PATCH v2 4/4] Document two argument form of gdb.Value constructor Message-ID: <20190219144553.4c6d873f@f29-4.lan> In-Reply-To: <20190219143356.1576e67f@f29-4.lan> References: <20190219143356.1576e67f@f29-4.lan> MIME-Version: 1.0 X-IsSubscribed: yes gdb/ChangeLog: * NEWS: Mention two argument form of gdb.Value constructor. gdb/doc/ChangeLog: * python.texi (Values From Inferior): Document second form of Value.__init__. --- gdb/NEWS | 3 +++ gdb/doc/python.texi | 8 ++++++++ 2 files changed, 11 insertions(+) diff --git a/gdb/NEWS b/gdb/NEWS index eaef6aa384..9ad7ff4885 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -202,6 +202,9 @@ FreeBSD/riscv riscv*-*-freebsd* gdb.SYMBOL_TYPES_DOMAIN are now deprecated. These were never correct and did not work properly. + ** The gdb.Value type has a new constructor, which is used to construct a + gdb.Value from a Python buffer object and a gdb.Type. + * Configure changes --enable-ubsan diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi index 2860361c33..7f6f52c4df 100644 --- a/gdb/doc/python.texi +++ b/gdb/doc/python.texi @@ -735,6 +735,14 @@ its result is used. @end table @end defun +@defun Value.__init__ (@var{val}, @r{[}, type @r{]}) +This second form of the @code{gdb.Value} constructor returns a +@code{gdb.Value} of type @var{type} where the value contents are taken +from the Python buffer object specified by @var{val}. The number of +bytes in the Python buffer object must be greater than or equal to the +size of @var{type}. +@end defun + @defun Value.cast (type) Return a new instance of @code{gdb.Value} that is the result of casting this instance to the type described by @var{type}, which must