atoi(3)

atoi3

Convert ascii string to integer

Usage

#include <stdlib.h>

int

atoi(const char *nptr);

Library

Standard C Library (libc, -lc)

Overview

The atoi() function converts the initial portion of the string pointed to by nptr to int representation.

It is equivalent to:

(int)strtol(nptr, NULL, 10);

The atoi() function has been deprecated by strtol() and should not be used in new code.

Errors

The function atoi() need not affect the value of errno on an error.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 40 times.

  1. 2.0.5–3.4
  2. 3.5–3.5.1
  3. 4.0
  4. 4.1–4.2
  5. 4.3–4.4
  6. 4.5–4.11
  7. 5.0
  8. 5.1–6.3
  9. 6.4
  10. 7.0
  11. 7.1
  12. 7.2
  13. 7.3
  14. 7.4
  15. 8.0
  16. 8.1
  17. 8.2
  18. 8.3
  19. 8.4
  20. 9.0
  21. 9.1
  22. 9.2
  23. 9.3
  24. 10.0
  25. 10.1
  26. 10.2
  27. 10.3
  28. 10.4
  29. 11.0
  30. 11.1
  31. 11.2
  32. 11.3
  33. 11.4
  34. 12.0
  35. 12.1
  36. 12.2
  37. 12.3
  38. 12.4
  39. 13.0–13.2
  40. 13.3–14.5
  41. 15.0–16.0

Standards

The atoi() function conforms to ISO/IEC 9945-1:1990 (“POSIX.1”), ISO/IEC 9899:1990 (“ISO C90”), and ISO/IEC 9899:1999 (“ISO C99”).

History

The atoi() function appeared in Version 1 AT&T UNIX.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.