From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 30829 invoked by alias); 21 Sep 2010 20:06:25 -0000 Received: (qmail 30813 invoked by uid 22791); 21 Sep 2010 20:06:23 -0000 X-SWARE-Spam-Status: No, hits=-6.2 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_HI,SPF_HELO_PASS,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 21 Sep 2010 20:06:18 +0000 Received: from int-mx08.intmail.prod.int.phx2.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by mx1.redhat.com (8.13.8/8.13.8) with ESMTP id o8LK68LL023710 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 21 Sep 2010 16:06:08 -0400 Received: from ns3.rdu.redhat.com (ns3.rdu.redhat.com [10.11.255.199]) by int-mx08.intmail.prod.int.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id o8LK67jf011475; Tue, 21 Sep 2010 16:06:08 -0400 Received: from opsy.redhat.com (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by ns3.rdu.redhat.com (8.13.8/8.13.8) with ESMTP id o8LK66sc012846; Tue, 21 Sep 2010 16:06:07 -0400 Received: by opsy.redhat.com (Postfix, from userid 500) id A4E10378875; Tue, 21 Sep 2010 14:06:06 -0600 (MDT) From: Tom Tromey To: Joel =?utf-8?Q?Borggr=C3=A9n-Franck?= Cc: =?utf-8?B?QW5kcsOpIFDDtm5pdHo=?= , gdb-patches@sourceware.org Subject: RFA: document Value.__init__ (Was: Python API questions and use cases) References: <201009161148.37670.andre.poenitz@nokia.com> Date: Tue, 21 Sep 2010 21:56:00 -0000 In-Reply-To: ("Joel =?utf-8?Q?Borggr=C3=A9n-Franck=22's?= message of "Fri, 17 Sep 2010 09:35:09 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2010-09/txt/msg00356.txt.bz2 >>>>> "Joel" =3D=3D Joel Borggr=C3=A9n-Franck writes: Joel> I can't find documentation for the constructor Andr=C3=A9 showed me: Joel> gdb.Value(addr). Here is a patch to document this constructor. Ok? Tom 2010-09-21 Tom Tromey * gdb.texinfo (Values From Inferior): Mention Value.__init__. Index: gdb.texinfo =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.764 diff -u -r1.764 gdb.texinfo --- gdb.texinfo 15 Sep 2010 19:31:59 -0000 1.764 +++ gdb.texinfo 21 Sep 2010 20:05:54 -0000 @@ -20774,6 +20774,22 @@ The following methods are provided: =20 @table @code +@defmethod Value __init__ @var{val} +Many Python values can be converted directly to a @code{gdb.Value} via +this object initializer. Specifically, Python booleans are converted +to boolean type from the current language; Python integers are +converted to the C @code{long} type for the current architecture; +Python longs are converted to the C @code{long long} type for the +current architecture; Python floats are converted to the C +@code{double} type for the current architecture; and Python strings +are converted to target strings, using the current target encoding. + +@code{val} can also be a @code{gdb.Value}, in which case a copy of the +value is returned, or a @code{gdb.LazyString} (@pxref{Lazy Strings In +Python}), in which case the lazy string's @code{value} method is +called, and its result is returned. +@end defmethod + @defmethod 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