_itoa() — Convert Integer to String
Format
#include <stdlib.h>
char *_itoa(int value, char *string, int radix);
Note: The
_itoa
function is supported
only for C++, not for C.Language Level
Extension
Threadsafe
Yes
Description
_itoa()
converts
the digits of the given value to a character
string that ends with a null character and stores the result in string.
The radix argument specifies the base of value;
it must be in the range 2 to 36. If radix equals
10 and value is negative, the first character
of the stored string is the minus sign (-).
Note: The space reserved for string must
be large enough to hold the returned string. The function can return
up to 33 bytes including the null character (\0).
Return Value
_itoa
returns
a pointer to string. There is no error return
value.
When the string argument is NULL or the radix is
outside the range 2 to 36, errno
will be set to EINVAL.
Example
This example converts the integer
value -255 to a decimal, a binary, and a hex number, storing its character
representation in the array buffer.
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
char buffer[35];
char *p;
p = _itoa(-255, buffer, 10);
printf("The result of _itoa(-255) with radix of 10 is %s\n", p);
p = _itoa(-255, buffer, 2);
printf("The result of _itoa(-255) with radix of 2\n is %s\n", p);
p = _itoa(-255, buffer, 16);
printf("The result of _itoa(-255) with radix of 16 is %s\n", p);
return 0;
}
The output should be: The result of _itoa(-255) with radix of 10 is -255
The result of _itoa(-255) with radix of 2
is 11111111111111111111111100000001
The result of _itoa(-255) with radix of 16 is ffffff01