HP C/iX Library Reference Manual (30026-90004)

Chapter 5 113

HP C/iX Library Function Descriptions

atoi

Converts a string to an integer.

Syntax

#include <stdlib.h>

int atoi (const char *

str

);

Parameters

str

A pointer to a character string to convert to an integer.

Return Values

x An integer value upon successful completion.

0 An error occurred. The

str

argument may have started with an

unrecognized character.

Description

The atoi function converts the string of characters pointed to by the

str

argument into an

integer. The atoi function skips over white space before looking for the start of the

number. The format of the input string is the same as that accepted by the %d scanf

format conversion.

This function converts as many characters as possible until it encounters an unrecognized

character. For example, if the received string is "19A1", atoi() returns 19.