NAME

       number-string -  (numbers)

PURPOSE

       Convert number to string.

SYNTAX

           number-string <number> [ to <string> ] \
               [ base <base> ] \
               [ status <status> ]

DESCRIPTION

       <number>  is  converted  to  <string>  in  "to" clause, using <base> in "base" clause, where <base> is by
       default 10. <base> can be between 2 and 36, inclusive. <number> can be positive or negative (i.e. signed)
       and can be of any integer type up to 64-bit (char, int,  long,  long  long  etc.).   If  "to"  clause  is
       omitted, then <number> is printed out.

       Note that any letters in <string> (depending on the <base>) are always lower-case.

       If  there  is  an  error,  such  as  if <base> is incorrect, then <status> number (in "status" clause) is
       GG_ERR_FAILED, otherwise it's GG_OKAY.

       Use of number-string (and print-out which is based on it) for converting and outputting numbers is  high-
       performance  and  recommended  if  your application needs to do that often. If number-string prints out a
       number (i.e. "to" clause is omitted), and this is within write-string, then <number> is output  into  the
       buffer that builds a new string.

EXAMPLES

       The following will allocate memory for string "x" to be "801":

           set-number x = 801
           number-string x to res

       The following will store "-238f" to string "res":

           set-number x = -9103
           number-string x to res base 16

       To print out a number -131:

           set-number x = -131
           number-string x

SEE ALSO

        Numbers

       abs-number number-expressions number-string set-number string-number See all documentation

$DATE                                               $VERSION                                           GOLF(2gg)