Home
Developer Resources

itoa

PDF Documents
Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

itoa()

Convert an integer into a string, using a given base

Synopsis:

#include <stdlib.h>

char* itoa( int value, 
            char* buffer, 
            int radix );

Arguments:

value
The value to convert into a string.
buffer
A buffer in which the function stores the string. The size of the buffer must be at least:
8 * sizeof( int ) + 1
  

bytes when converting values in base 2 (binary).

radix
The base to use when converting the number.

If the value of radix is 10, and value is negative, then a minus sign is prepended to the result.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The itoa() function converts the integer value into the equivalent string in base radix notation, storing the result in the specified buffer. The function terminates the string with a NUL character.

Returns:

A pointer to the resulting string.

Examples:

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
    char buffer[20];
    int base;

    for( base = 2; base <= 16; base += 2 ) {
        printf( "%2d %s\n", base,
            itoa( 12765, buffer, base ) );
    }
    
    return EXIT_SUCCESS;
}

produces the output:

 2 11000111011101
 4 3013131
 6 135033
 8 30735
10 12765
12 7479
14 491b
16 31dd

Classification:

QNX 4

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

atoi(), atol(), ltoa(), sscanf(), strtol(), strtoul(), ultoa(), utoa()