[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Synopsis:
#include <stdlib.h>
char *utoa( unsigned int value,
char *buffer,
int radix );
char *_utoa( unsigned int value,
char *buffer,
int radix );
wchar_t *_utow( unsigned int value,
wchar_t *buffer,
int radix );
wchar_t *_utou( unsigned int value,
wchar_t *buffer,
int radix );
Description:
The utoa function converts the unsigned binary integer value into the
equivalent string in base radix notation storing the result in the
character array pointed to by buffer. A null character is appended to
the result. The size of buffer must be at least (8 * sizeof(int) + 1)
bytes when converting values in base 2. That makes the size 17 bytes on
16-bit machines, and 33 bytes on 32-bit machines. The value of radix
must satisfy the condition:
2 <= radix <= 36
The _utoa function is identical to utoa. Use _utoa for ANSI/ISO naming
conventions.
The _utow function is identical to utoa except that it produces a
wide-character string (which is twice as long).
The _utow Unicode function is identical to utoa except that it produces
a Unicode character string (which is twice as long).
Returns:
The utoa function returns the pointer to the result.
Example:
#include <stdio.h>
#include <stdlib.h>
void main()
{
int base;
char buffer[18];
for( base = 2; base <= 16; base = base + 2 )
printf( "%2d %s\n", base,
utoa( (unsigned) 12765, buffer, base ) );
}
produces the following:
2 11000111011101
4 3013131
6 135033
8 30735
10 12765
12 7479
14 491b
16 31dd
Classification:
WATCOM
_utoa conforms to ANSI/ISO naming conventions
Systems:
utoa - All, Netware
_utoa - All, Netware
_utow - All
See Also:
atoi, atol, itoa, ltoa, sscanf, strtol, strtoul, ultoa
See Also:
Online resources provided by: http://www.ClipX.Net --- NG 2 HTML conversion by Dave Pearson