Как преобразовать String в int в Java

Превратить текст вроде "42" в число 42 — одна из самых распространённых задач в Java: она возникает каждый раз, когда вы читаете аргументы командной строки, разбираете значение конфигурации или обрабатываете пользовательский ввод. JDK предоставляет пару однострочных инструментов для этого в классе Integer, а также понятный сценарий ошибки, если текст не является допустимым числом. В этой главе показаны идиоматические подходы и способы обработки некорректных случаев.

`Integer.parseInt` — примитивный `int`, который обычно нужен

Integer.parseInt(String) — основной инструмент. Он читает текст и возвращает примитивный int:

int count = Integer.parseInt("42");   // 42
int neg   = Integer.parseInt("-7");   // -7

Ведущий + или - допускается, но ничего больше: пробелы вокруг, десятичные точки, подчёркивания или буквы — всё это приводит к ошибке. Если возможны пробелы, предварительно обрежьте их с помощью s.trim() (или s.strip() в Java 11+). Существует также перегрузка, принимающая основание системы счисления: Integer.parseInt("ff", 16) читает шестнадцатеричное число и возвращает 255.

`Integer.valueOf` — когда нужен объект `Integer`

Integer.valueOf(String) выполняет то же разбирание, но возвращает Integer (обёрнутый тип), а не примитивный int. Используйте его, когда значение сразу помещается в коллекцию вроде List<Integer> или в любое место, где требуется ссылка на объект. В качестве бонуса valueOf кэширует обёрнутые экземпляры для небольших значений (от −128 до 127), поэтому он может быть незначительно дешевле, чем parseInt с последующим автоупаковкой.

Подход	Возвращает	Используйте когда
`Integer.parseInt(s)`	примитивный `int`	нужно сразу выполнить арифметику
`Integer.valueOf(s)`	объект `Integer`	нужна обёртка для коллекции или дженериков
`Integer.parseInt(s, radix)`	примитивный `int`	текст записан в основании 2, 8, 16 и т.д.

Обработка некорректного ввода с помощью `NumberFormatException`

Оба метода бросают непроверяемое исключение NumberFormatException, когда строка не является допустимым целым числом — "12x", "3.14", "" или null — все они завершаются ошибкой. Поскольку исключение непроверяемое, компилятор не заставит вас его перехватывать, поэтому вы сами должны защитить входные данные, которые не контролируете:

String raw = userInput();
try {
  int value = Integer.parseInt(raw.trim());
  // ... use value
} catch (NumberFormatException e) {
  System.out.println("Not a whole number: " + raw);
}

Когда разбор «иногда ожидаемо завершается неудачей» и вы не хотите исключений в потоке управления, оберните его в вспомогательный метод, возвращающий OptionalInt вместо бросания исключения. Это превращает try/catch в чистую проверку isPresent() на стороне вызова. Смотрите Java Optional для изучения широкого паттерна, и Java try-catch для понимания механики перехвата исключений.

Практический пример: все подходы рядом

Эта программа выполняет каждую технику преобразования и два сценария ошибки, чтобы вы могли увидеть, что именно каждый из них возвращает или печатает:

java— editable, runs on the server

import java.util.OptionalInt;

public class StringToIntDemo {
  public static void main(String[] args) {
    // 1. The everyday tool: Integer.parseInt returns a primitive int.
    int n = Integer.parseInt("42");
    System.out.println("parseInt(\"42\")        = " + n);

// 2. Integer.valueOf returns an Integer object (and caches small values).
    Integer boxed = Integer.valueOf("42");
    System.out.println("valueOf(\"42\")         = " + boxed);

// 3. A second argument parses other radixes. "ff" in base 16 is 255.
    int hex = Integer.parseInt("ff", 16);
    System.out.println("parseInt(\"ff\", 16)    = " + hex);

// 4. Bad input is rejected loudly with NumberFormatException.
    try {
      Integer.parseInt("12x");
    } catch (NumberFormatException e) {
      System.out.println("parseInt(\"12x\") threw: " + e.getMessage());
    }

// 5. A null is also a NumberFormatException, not a NullPointerException.
    try {
      Integer.parseInt(null);
    } catch (NumberFormatException e) {
      System.out.println("parseInt(null) threw : " + e.getMessage());
    }

// 6. A safe, branch-free wrapper that never throws.
    OptionalInt parsed = tryParse("  7 ");
    System.out.println("tryParse(\"  7 \")      = " + (parsed.isPresent() ? parsed.getAsInt() : "absent"));
    OptionalInt bad = tryParse("nope");
    System.out.println("tryParse(\"nope\")      = " + (bad.isPresent() ? bad.getAsInt() : "absent"));
  }

static OptionalInt tryParse(String s) {
    if (s == null) return OptionalInt.empty();
    try {
      return OptionalInt.of(Integer.parseInt(s.trim()));
    } catch (NumberFormatException e) {
      return OptionalInt.empty();
    }
  }
}

Что следует вынести из выполнения:

Integer.parseInt("42") печатает 42 как примитивный int, а Integer.valueOf("42") печатает то же 42 — разница в типе: объект против примитива, а не в значении.
Перегрузка с основанием превращает "ff" в 255, доказывая, что второй аргумент управляет системой счисления; без основания по умолчанию используется 10.
"12x" отклоняется с NumberFormatException, сообщение которого — For input string: "12x" — исключение называет именно тот текст, который не удалось разобрать, что делает его полезным в логах.
Передача null бросает NumberFormatException (сообщение Cannot parse null string), а не NullPointerException — поэтому один перехват NumberFormatException покрывает как некорректный, так и null-ввод.
Вспомогательный метод tryParse обрезает " 7 " до 7 и возвращает absent для "nope", никогда не бросая исключений — это паттерн, который следует использовать, когда некорректный ввод является нормой, а не исключением.

Практика

Что происходит при вызове Integer.parseInt('3.14') в Java?

Бросается NumberFormatException, потому что '3.14' не является допустимым целым числомВозвращается 3, молча отбрасывая дробную частьВозвращается 3.14 как doubleВозвращается 0, потому что разбор не удался

Связанные темы

Как преобразовать int в String в Java — обратное направление.
Java Exceptions — основы NumberFormatException и семейства непроверяемых исключений.
Java Data Types — разница между примитивом int и обёрткой Integer.