std:: strtol, std:: strtoll

Interpretiert einen ganzzahligen Wert in einem Byte-String, auf den gezeigt wird von str .

Verwirft alle Leerzeichen (wie durch Aufruf von std::isspace identifiziert) bis zum ersten Nicht-Leerzeichen, dann nimmt so viele Zeichen wie möglich, um eine gültige Basis-n (wobei n= base ) Ganzzahldarstellung zu bilden und konvertiert sie in einen Ganzzahlwert. Der gültige Ganzzahlwert besteht aus folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• (optional) Präfix ( 0 ), das die Oktalbasis angibt (gilt nur, wenn die Basis 8 oder ​ 0 ​ ist)
• (optional) Präfix ( 0x oder 0X ), das die Hexadezimalbasis angibt (gilt nur, wenn die Basis 16 oder ​ 0 ​ ist)
• eine Ziffernfolge

Die Menge der gültigen Werte für die Basis ist {0, 2, 3, ..., 36} . Die Menge der gültigen Ziffern für Basis- 2 -Integer ist {0, 1} , für Basis- 3 -Integer ist {0, 1, 2} , und so weiter. Für Basen größer als 10 umfassen gültige Ziffern alphabetische Zeichen, beginnend mit Aa für Basis- 11 -Integer, bis zu Zz für Basis- 36 -Integer. Die Groß-/Kleinschreibung der Zeichen wird ignoriert.

Zusätzliche numerische Formate können von der aktuell installierten C- locale akzeptiert werden.

Wenn der Wert von base ​ 0 ​ beträgt, wird die numerische Basis automatisch erkannt: wenn das Präfix 0 ist, ist die Basis oktal, wenn das Präfix 0x oder 0X ist, ist die Basis hexadezimal, andernfalls ist die Basis dezimal.

Wenn das Minuszeichen Teil der Eingabesequenz war, wird der aus der Ziffernfolge berechnete numerische Wert negiert, als ob durch unary minus im Ergebnistyp.

Die Funktion setzt den Zeiger, auf den str_end zeigt, so, dass er auf das Zeichen nach dem letzten interpretierten Zeichen zeigt. Wenn str_end ein Nullzeiger ist, wird er ignoriert.

Wenn die str leer ist oder nicht die erwartete Form hat, wird keine Konvertierung durchgeführt, und (falls str_end kein Nullzeiger ist) wird der Wert von str in dem Objekt gespeichert, auf das str_end zeigt.

Parameter

Rückgabewert

• Bei Erfolg wird ein ganzzahliger Wert zurückgegeben, der dem Inhalt von str entspricht.
• Falls der konvertierte Wert außerhalb des Bereichs des entsprechenden Rückgabetyps liegt, tritt ein Bereichsfehler auf (wobei errno auf ERANGE gesetzt wird) und LONG_MAX , LONG_MIN , LLONG_MAX oder LLONG_MIN zurückgegeben wird.
• Falls keine Konvertierung durchgeführt werden kann, wird ​ 0 ​ zurückgegeben.

Beispiel

#include <cerrno>
#include <cstdlib>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    const char* p = "10 200000000000000000000000000000 30 -40";
    std::cout << "Parsing " << std::quoted(p) << ":\n";
    for (;;)
    {
        // errno can be set to any non-zero value by a library function call
        // regardless of whether there was an error, so it needs to be cleared
        // in order to check the error set by strtol
        errno = 0;
        char* p_end{};
        const long i = std::strtol(p, &p_end, 10);
        if (p == p_end)
            break;
        const bool range_error = errno == ERANGE;
        const std::string extracted(p, p_end - p);
        p = p_end;
        std::cout << "Extracted " << std::quoted(extracted)
                  << ", strtol returned " << i << '.';
        if (range_error)
            std::cout << "\n  Range error occurred.";
        std::cout << '\n';
    }
}

Parsing "10 200000000000000000000000000000 30 -40":
Extracted "10", strtol returned 10.
Extracted " 200000000000000000000000000000", strtol returned 9223372036854775807.
  Range error occurred.
Extracted " 30", strtol returned 30.
Extracted " -40", strtol returned -40.

Siehe auch