number-string <number> [ to <string> ] \
[ base <base> ] \
[ status <status> ]
Copied!
<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 p-num 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
Copied!
The following will store "-238f" to string "res":
set-number x = -9103 number-string x to res base16
