atoi, _atoi_l, , _wtoi_wtoi_l

Převede řetězec na celé číslo.

Syntaxe

int atoi(
   const char *str
);
int _wtoi(
   const wchar_t *str
);
int _atoi_l(
   const char *str,
   _locale_t locale
);
int _wtoi_l(
   const wchar_t *str,
   _locale_t locale
);

Parametry

str
Řetězec, který se má převést.

locale
Národní prostředí, které se má použít.

Vrácená hodnota

Každá funkce vrátí hodnotu vytvořenou int interpretací vstupních znaků jako čísla. Vrácená hodnota je 0 pro atoi a _wtoi, pokud vstup nelze převést na hodnotu tohoto typu.

Při přetečení funkcí s velkými zápornými celočíselnými hodnotami se LONG_MIN vrátí. atoi a _wtoi vracet INT_MAX a INT_MIN v těchto podmínkách. Ve všech případech errno mimo rozsah je nastavena hodnota ERANGE. Pokud je NULLparametr předán , je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je možné pokračovat spuštěním, tyto funkce jsou nastavené errno na EINVAL hodnotu 0 a vrátí hodnotu 0.

Poznámky

Tyto funkce převádějí řetězec znaků na celočíselnou hodnotu (atoi a _wtoi). Vstupní řetězec je posloupnost znaků, kterou lze interpretovat jako číselnou hodnotu zadaného typu. Funkce přestane číst vstupní řetězec na prvním znaku, který nedokáže rozpoznat jako součást čísla. Tento znak může být znak null (\0 nebo L'\0'), který ukončuje řetězec.

Argument str atoi _wtoi a má následující tvar:

[] [whitespace] [digitssign]

Jedná whitespace se o mezeru nebo znaky tabulátoru, které se ignorují; sign jsou buď plus (+) nebo minus (-), a digits jsou jedna nebo více číslic.

Verze těchto funkcí s příponou _l jsou shodné s tím rozdílem, že místo aktuálního národního prostředí používají předaný parametr národního prostředí. Další informace naleznete v tématu Národní prostředí.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Požadavky

Příklad

Tento program ukazuje, jak lze čísla uložená jako řetězce převést na číselné hodnoty pomocí atoi funkcí.

// crt_atoi.c
// This program shows how numbers
// stored as strings can be converted to
// numeric values using the atoi functions.

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

int main( void )
{
    char    *str = NULL;
    int     value = 0;

    // An example of the atoi function.
    str = "  -2309 ";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function.
    str = "31412764";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function
    // with an overflow condition occurring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}

Function: atoi( "  -2309 " ) = -2309
Function: atoi( "31412764" ) = 31412764
Function: atoi( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.

Viz také

Konverze dat
Podpora pro matematiku a plovoucí desetinou čárku
Národní prostředí
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, , _atoflt_atoflt_l