_ltoa - Convert Long Integer to String

Format

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

Note:
The _ltoa function is supported only for C++, not for C.

Language Level: Extension

Threadsafe: Yes.

Description

_ltoa converts the digits of the given long integer 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 allocated 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

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

This example converts the integer value -255L to a decimal, a binary, and a hex value, and stores its character representation in the array buffer.

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
   char buffer[35];
   char *p;
   p = _ltoa(-255L, buffer, 10);
   printf("The result of _ltoa(-255) with radix of 10 is %s\n", p);
   p = _itoa(-255L, buffer, 2);
   printf("The result of _ltoa(-255) with radix of 2\n    is %s\n", p);
   p = _itoa(-255L, buffer, 16);
   printf("The result of _ltoa(-255) with radix of 16 is %s\n", p);
   return 0;
}

The output should be:

      The result of _ltoa(-255) with radix of 10 is -255
      The result of _ltoa(-255) with radix of 2
          is 11111111111111111111111100000001
      The result of _ltoa(-255) with radix of 16 is ffffff01

Related Information:



[ Top of Page | Previous Page | Next Page | Contents | Index ]