Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

atoi — knjižnična funkcija C23

`atoi(const char *nptr)` iz `<stdlib.h>` pretvori začetno desetiško celo število v nizu in vrne `int`. Preskoči začetne presledke, sprejme neobvezen predznak in se ustavi pri prvem znaku, ki ni del števila.

Različica: C23

Sintaksa

int atoi(const char *nptr);

atoi(const char *nptr) iz <stdlib.h> pretvori začetno desetiško celo število v nizu in vrne int. Preskoči začetne presledke, sprejme neobvezen predznak in se ustavi pri prvem znaku, ki ni del števila.

Primerna je le za majhne, vnaprej preverjene konfiguracijske vrednosti. Primer res poda " -42items", zato dobi -42 in prezre pripono items.

Brez števk vrne 0, kar se ne loči od veljavne ničle. Če rezultata ni mogoče predstaviti kot int, je po C23 vedenje nedoločeno; nptr ne sme biti NULL. Za nezaupno besedilo uporabi strtol ter preveri končni kazalec, errno in INT_MIN..INT_MAX.

Primeri

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

int main(void) {
    int count = atoi("  -42items");
    printf("%d\n", count);
    return 0;
}

Rezultat

-42

Primerna je le za majhne, vnaprej preverjene konfiguracijske vrednosti. Primer res poda `" -42items"`, zato dobi `-42` in prezre pripono `items`.

Viri