Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Tcl_GetInt(3)		    Tcl	Library	Procedures		 Tcl_GetInt(3)


       Tcl_GetInt,  Tcl_GetDouble, Tcl_GetBoolean - convert from string	to in-
       teger, double, or boolean

       #include	<tcl.h>

       Tcl_GetInt(interp, src, intPtr)

       Tcl_GetDouble(interp, src, doublePtr)

       Tcl_GetBoolean(interp, src, boolPtr)

       Tcl_Interp *interp (in)		   Interpreter to use  for  error  re-

       const char *src (in)		   Textual value to be converted.

       int *intPtr (out)		   Points  to  place  to store integer
					   value converted from	src.

       double *doublePtr (out)		   Points to place  to	store  double-
					   precision floating-point value con-
					   verted from src.

       int *boolPtr (out)		   Points to place  to	store  boolean
					   value (0 or 1) converted from src.

       These  procedures  convert from strings to integers or double-precision
       floating-point values or	booleans (represented as 0- or 1-valued	 inte-
       gers).	Each of	the procedures takes a src argument, converts it to an
       internal	form of	a particular type, and stores the converted  value  at
       the  location indicated by the procedure's third	argument.  If all goes
       well, each of the procedures returns TCL_OK.  If	src does not have  the
       proper syntax for the desired type then TCL_ERROR is returned, an error
       message is left in the interpreter's result, and	nothing	is  stored  at
       *intPtr or *doublePtr or	*boolPtr.

       Tcl_GetInt  expects  src	 to consist of a collection of integer digits,
       optionally signed and optionally	preceded and followed by white	space.
       If  the	first two characters of	src after the optional white space and
       sign are	"0x" then src is expected to be	in hexadecimal	form;	other-
       wise,  if the first such	characters are "0o" then src is	expected to be
       in octal	form;  otherwise, if the first such characters are  "0b"  then
       src  is	expected  to  be in binary form;  otherwise, if	the first such
       character is "0"	then src is expected to	be in octal form;   otherwise,
       src is expected to be in	decimal	form.

       Tcl_GetDouble  expects src to consist of	a floating-point number, which
       is:  white space;  a sign; a sequence of	digits;	 a decimal point  ".";
       a  sequence of digits;  the letter "e"; a signed	decimal	exponent;  and
       more white space.  Any of the fields may	be omitted,  except  that  the
       digits  either before or	after the decimal point	must be	present	and if
       the "e" is present then it must be followed by the exponent number.  If
       there  are no fields apart from the sign	and initial sequence of	digits
       (i.e., no decimal point or exponent indicator), that  initial  sequence
       of  digits  should  take	one of the forms that Tcl_GetInt supports, de-
       scribed above. The use of "," as	a decimal point	is not	supported  nor
       should any other	sort of	inter-digit separator be present.

       Tcl_GetBoolean  expects	src to specify a boolean value.	 If src	is any
       of 0, false, no,	or off,	then Tcl_GetBoolean stores  a  zero  value  at
       *boolPtr.   If  src  is any of 1, true, yes, or on, then	1 is stored at
       *boolPtr.  Any of these	values	may  be	 abbreviated,  and  upper-case
       spellings are also acceptable.

       boolean,	conversion, double, floating-point, integer

Tcl								 Tcl_GetInt(3)


Want to link to this manual page? Use this URL:

home | help