_itoa - Convert Integer to String

Format

#include <stdlib.h>
char *_itoa(int value, char *string, int radix);

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 (-).

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 that uses _itoa()

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

Related Information:

• _gcvt - Convert Floating-Point to String
• _itoa - Convert Integer to String
• _ltoa - Convert Long Integer to String
• _ultoa - Convert Unsigned Long Integer to String
• <stdlib.h>