HOWTO · C++

Wie konvertiert man ein Char-Array nach Int in C++

Dieser Artikel zeigt Möglichkeiten zur Konvertierung eines Char-Arrays in C++ in den Typ int

Auf dieser Seite

Ein nullterminiertes char-Array kann Text enthalten, der eine ganze Zahl darstellt. C++ bietet mehrere Möglichkeiten, diesen Text zu parsen. Die Funktionen unterscheiden sich jedoch darin, wie sie Fehler melden und ob sie einen numerischen Präfix akzeptieren, auf den weitere Zeichen folgen. Wählen Sie das Verfahren danach aus, ob die Eingabe vertrauenswürdig ist und ob das gesamte Array eine gültige Zahl enthalten muss.

Die Beispiele verwenden Dezimaleingaben. Eine erfolgreiche Konvertierung eines Präfixes bedeutet nicht unbedingt, dass alle Zeichen verarbeitet wurden: Beim Parsen von "23323tail" kann beispielsweise 23323 entstehen, während tail unverarbeitet bleibt. Wenn die gesamte Eingabe numerisch sein muss, prüfen Sie neben dem Konvertierungsergebnis auch die Endposition des Parsers.

Verwenden Sie die Funktion std::strtol, um ein char-Array in einen int zu konvertieren

std::strtol parst eine nullterminierte Zeichenfolge und gibt einen long zurück. Mit dem dritten Argument legen Sie die Basis fest: Verwenden Sie 10 für Dezimalzahlen, 16 für Hexadezimalzahlen oder 0, damit die Basis anhand eines Präfixes erkannt wird. Bei einer Basis ungleich null sind Werte von 2 bis 36 zulässig.

Das zweite Argument erhält einen Zeiger auf das erste Zeichen, das nicht verarbeitet wurde. Zeigt dieser weiterhin auf den Anfang der Eingabe, wurden keine Ziffern geparst. Zeigt er auf das abschließende Nullzeichen, wurde die gesamte Zeichenfolge verarbeitet. Setzen Sie errno vor dem Funktionsaufruf auf null und prüfen Sie anschließend auf ERANGE, um ein Ergebnis außerhalb des long-Wertebereichs zu erkennen. Da das Ergebnis vom Typ long ist, vergleichen Sie es außerdem mit std::numeric_limits<int>::min() und max(), bevor Sie es in einem int speichern.

Führen Sie dieses Beispiel aus. Es verwendet Dezimaltext in einem nullterminierten Zeichenarray und gibt die geparste Ganzzahl aus.

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

#include <cerrno>
#include <cstdlib>
#include <iostream>
#include <limits>

int main() {
  const char input[] = "23323";
  char* end = nullptr;
  errno = 0;
  const long parsed = std::strtol(input, &end, 10);

  if (end == input || *end != '\0' || errno == ERANGE ||
      parsed < std::numeric_limits<int>::min() ||
      parsed > std::numeric_limits<int>::max()) {
    std::cout << "Could not convert the complete input.\n";
    return 0;
  }

  const int value = static_cast<int>(parsed);
  std::cout << value << '\n';
}

Der bereitgestellte Lauf für diesen Erfolgsfall wurde mit Exitcode 0 beendet und gab Folgendes aus:

23323

Der Lauf deckt nur diese gültige Eingabe ab; er belegt nicht das Verhalten bei fehlgeschlagenen Konvertierungen oder Werten außerhalb des zulässigen Bereichs. Behalten Sie die Prüfungen in Produktionscode bei: Sie unterscheiden zwischen keiner erfolgten Konvertierung, verbleibenden Zeichen, einem long-Bereichsfehler und einem Wert, der nicht in einen int passt.

Verwenden Sie die Funktion std::atoi, um ein char-Array in einen int zu konvertieren

std::atoi ist eine kurze Möglichkeit, wenn die Eingabe bereits vertrauenswürdig und korrekt formatiert ist:

int value = std::atoi(input);

Die Funktion akzeptiert führende Leerzeichen und ein optionales Vorzeichen und parst anschließend Dezimalziffern. Wie andere Parser, die Präfixe verarbeiten, kann sie bei einem Nicht-Ziffernzeichen anhalten und die restlichen Zeichen ignorieren. Sie bietet keine zuverlässige Möglichkeit, eine gültige Null von einer fehlgeschlagenen Konvertierung zu unterscheiden, und keinen brauchbaren Meldeweg für Bereichsfehler. Ist der geparste Wert nicht als int darstellbar, ist das Verhalten undefiniert. Verwenden Sie std::atoi daher nicht für ungeprüfte oder nicht vertrauenswürdige Zahleneingaben. Verwenden Sie std::strtol, wenn die Eingabe fehlerhaft oder außerhalb des Wertebereichs sein kann oder wenn der aufrufende Code Konvertierungsdiagnosen und eine ausdrückliche Prüfung des int-Wertebereichs benötigt.

Verwenden Sie die Funktion std::sscanf, um ein char-Array in einen int zu konvertieren

std::sscanf wendet ein Format auf Text an und meldet, wie viele Konvertierungen erfolgreich waren. Prüfen Sie bei einer einzelnen Ganzzahl vor der Verwendung des Zielwerts, ob der Rückgabewert 1 ist:

int value = 0; int converted = std::sscanf(input, "%d", &value);

%d akzeptiert führende Leerzeichen und ein optionales Vorzeichen und liest dann Dezimalziffern. Die Funktion kann ein Präfix erfolgreich parsen und nachfolgende Zeichen unverarbeitet lassen. Wenn die gesamte Eingabe verarbeitet werden muss, verwenden Sie eine zusätzliche Formatprüfung oder ein anderes Parseverfahren. Das Ziel muss ein echtes, beschreibbares int-Objekt sein und darf nur gelesen werden, wenn die Anzahl der Konvertierungen bestätigt, dass eine Konvertierung stattgefunden hat. Diese Anzahl macht einen nicht darstellbaren Wert nicht sicher: Lässt sich der erkannte Wert nicht als int darstellen, ist das Verhalten undefiniert. Verwenden Sie %d nicht für ungeprüfte oder nicht vertrauenswürdige Zahleneingaben, die außerhalb des Wertebereichs liegen können. Für diese einfache Aufgabe macht std::strtol die Prüfungen der Endposition und des Wertebereichs deutlicher.

Verwenden Sie eine Schleife, um ein char-Array in einen int zu konvertieren

Eine Schleife eignet sich, wenn die erlaubte Syntax bewusst individuell festgelegt wird. Definieren Sie diese Syntax zuerst. Ein Dezimalparser könnte beispielsweise ein optionales führendes + oder - akzeptieren, mindestens eine Ziffer verlangen und alle anderen Zeichen ablehnen. Außerdem muss er vor jeder Multiplikation und Addition prüfen, ob die nächste Ziffer innerhalb des gewählten Ganzzahlbereichs bleibt. Andernfalls kann ein vorzeichenbehafteter Überlauf das Ergebnis verfälschen oder undefiniertes Verhalten verursachen.

Überspringen Sie nicht beliebige Nicht-Ziffern und hängen Sie später gefundene Ziffern an: Aus "23tail4" den Wert 234 zu machen, filtert Zeichen heraus, statt eine Ganzzahl zu parsen. Ein vollständiger eigener Parser muss die Position des Vorzeichens, die Ziffernvalidierung, die Verarbeitung der gesamten Eingabe und Überläufe behandeln. Wenn diese benutzerdefinierten Regeln nicht erforderlich sind, verwenden Sie stattdessen std::strtol und dessen Endzeiger.

Fazit

Für allgemeine Konvertierungen empfiehlt sich std::strtol: Die Funktion liefert die Abbruchposition und ermöglicht es, Fehler im long-Wertebereich zu erkennen. Vor der Konvertierung lässt sich das Ergebnis außerdem mit den Grenzen von int vergleichen. Verwenden Sie std::atoi nur bei vertrauenswürdigen, korrekt formatierten Eingaben, für die keine ausführlichen Diagnosen nötig sind. Wählen Sie std::sscanf, wenn eine formatgesteuerte Verarbeitung hilfreich ist, und prüfen Sie die Anzahl der Konvertierungen. Schreiben Sie eine Schleife, wenn das Programm eine bewusst andere Eingabegrammatik benötigt, und implementieren Sie Prüfungen für Vorzeichen, Ziffern, vollständige Verarbeitung und Überläufe ausdrücklich.