aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorPaul Koning <pkoning@equallogic.com>2011-10-25 18:35:19 +0000
committerPaul Koning <pkoning@equallogic.com>2011-10-25 18:35:19 +0000
commit22dbab4672e0b4aa7259b24594bb74d92f1c059e (patch)
tree17909b66f7e2b3819bfd2cc152436da00c530861 /gdb/doc
parent913460fcdec816bfc5b72c9f48b46481a418cba1 (diff)
downloadgdb-22dbab4672e0b4aa7259b24594bb74d92f1c059e.zip
gdb-22dbab4672e0b4aa7259b24594bb74d92f1c059e.tar.gz
gdb-22dbab4672e0b4aa7259b24594bb74d92f1c059e.tar.bz2
PR python/13327
* gdb.texinfo (Values From Inferior): Add is_lazy attribute, fetch_lazy method.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog7
-rw-r--r--gdb/doc/gdb.texinfo28
2 files changed, 35 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 9169d8e..5b38a67 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,10 @@
+2011-10-25 Paul Koning <paul_koning@dell.com>
+
+ PR python/13327
+
+ * gdb.texinfo (Values From Inferior): Add is_lazy attribute,
+ fetch_lazy method.
+
2011-10-20 Phil Muldoon <pmuldoon@redhat.com>
PR python/12656
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 69e2bda..853692c 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -21681,6 +21681,21 @@ that includes @acronym{RTTI} for the object in question. Otherwise,
it will just return the static type of the value as in @kbd{ptype foo}
(@pxref{Symbols, ptype}).
@end defvar
+
+@defvar Value.is_lazy
+The value of this read-only boolean attribute is @code{True} if this
+@code{gdb.Value} has not yet been fetched from the inferior.
+@value{GDBN} does not fetch values until necessary, for efficiency.
+For example:
+
+@smallexample
+myval = gdb.parse_and_eval ('somevar')
+@end smallexample
+
+The value of @code{somevar} is not fetched at this time. It will be
+fetched when the value is needed, or when the @code{fetch_lazy}
+method is invoked.
+@end defvar
@end table
The following methods are provided:
@@ -21814,6 +21829,19 @@ fetched and encoded to the length of characters specified. If
the @var{length} argument is not provided, the string will be fetched
and encoded until a null of appropriate width is found.
@end defun
+
+@defun Value.fetch_lazy ()
+If the @code{gdb.Value} object is currently a lazy value
+(@code{gdb.Value.is_lazy} is @code{True}), then the value is
+fetched from the inferior. Any errors that occur in the process
+will produce a Python exception.
+
+If the @code{gdb.Value} object is not a lazy value, this method
+has no effect.
+
+This method does not return a value.
+@end defun
+
@end table
@node Types In Python