summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorbch <brad.harder@gmail.com>2020-12-06 18:39:21 (GMT)
committerbch <brad.harder@gmail.com>2020-12-06 18:39:21 (GMT)
commitc9c1696a2d8c2c3d094e54b96defd269c0687692 (patch)
treec7c98017b4ab7b39f9dfb815b5c490ba9827e921 /doc
parent53d6118a090b1b452072c01b26df2bd43ee8e49b (diff)
downloadtcl-c9c1696a2d8c2c3d094e54b96defd269c0687692.zip
tcl-c9c1696a2d8c2c3d094e54b96defd269c0687692.tar.gz
tcl-c9c1696a2d8c2c3d094e54b96defd269c0687692.tar.bz2
allow NULL for indexPtr to say "am not interested in index, just membership in set of possibilities" for Tcl_GetIndexFromObj()
Diffstat (limited to 'doc')
-rw-r--r--doc/GetIndex.38
1 files changed, 4 insertions, 4 deletions
diff --git a/doc/GetIndex.3 b/doc/GetIndex.3
index 8591c56..111ae62 100644
--- a/doc/GetIndex.3
+++ b/doc/GetIndex.3
@@ -56,8 +56,8 @@ OR-ed combination of bits providing additional information for
operation. The only bits that are currently defined are \fBTCL_EXACT\fR
and \fBTCL_INDEX_TEMP_TABLE\fR.
.AP int *indexPtr out
-The index of the string in \fItablePtr\fR that matches the value of
-\fIobjPtr\fR is returned here.
+If not NULL, the index of the string in \fItablePtr\fR that matches
+the value of \fIobjPtr\fR is returned here.
.BE
.SH DESCRIPTION
.PP
@@ -70,8 +70,8 @@ the strings in \fItablePtr\fR to find a match. A match occurs if
\fItablePtr\fR, or if it is a non-empty unique abbreviation
for exactly one of the strings in \fItablePtr\fR and the
\fBTCL_EXACT\fR flag was not specified; in either case
-the index of the matching entry is stored at \fI*indexPtr\fR
-and \fBTCL_OK\fR is returned.
+\fBTCL_OK\fR is returned. If \fI*indexPtr\fR is not NULL the index
+of the matching entry is stored there.
.PP
If there is no matching entry,
\fBTCL_ERROR\fR is returned and an error message is left in \fIinterp\fR's