strtoul, _strtoul_l, wcstoul, _wcstoul_l

Artikel
02/26/2013

Konvertieren von Zeichenfolgen zu einem LONG Zahl-Wert ohne Vorzeichen.

unsigned long strtoul(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned long _strtoul_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned long _wcstoul_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Parameter

nptr
Klicken Sie auf NULL endende Zeichenfolge zu konvertieren.
endptr
Zeiger auf Zeichen, das die Überprüfung beendet.
base
Der zu verwendende Basis.
locale
Der zu verwendende Gebietsschema.

Rückgabewert

strtoul gibt den konvertierten Wert (falls vorhanden) oder bei einem Überlauf eine ULONG_MAX zurück.strtoul gibt 0 zurück, wenn keine Konvertierung ausgeführt werden kann.wcstoul gibt Werte analog zu strtoulzurück.Für beide Funktionen wird errno zu ERANGE festgelegt, wenn Überlauf oder Unterlauf auftritt.

Weitere Informationen finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr Weitere Informationen über diese und andere Rückgabecodes.

Hinweise

Jede dieser Funktionen wird die Eingabezeichenfolge nptr zu unsigned long.

strtoul abgebrochen, nptr am ersten Zeichen der Zeichenfolge zu lesen, das sie nicht als Teil einer Zahl erkennen kann.Dies ist möglicherweise NULL, oder es ist möglicherweise die erste größer oder gleich basenumerische Zeichen.Die LC_NUMERIC Kategorieeinstellung des Gebietsschemas bestimmt Erkennung des Basis Signierung in nptr. Weitere Informationen finden Sie unter setlocale.strtoul undwcstoul verwenden das aktuelle Gebietsschema. _strtoul_l und_wcstoul_l sind identisch, mit der Ausnahme, dass sie verwenden Sie stattdessen das Gebietsschema, das übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Wenn endptr nicht NULList, wird ein Zeiger auf das Zeichen, das die Überprüfung beendet wurde, am Speicherort gespeichert, der durch endptrdargestellt wird.Wenn keine Konvertierung ausgeführt werden kann (keine gültigen Ziffern gefunden wurden, oder eine ungültige Basis) angegeben wurde, wird der Wert von nptr am Speicherort gespeichert, der durch endptrdargestellt wird.

wcstoul ist eine Breitzeichen-Version von strtoul. handeln nptr-Argument ist eine Zeichenfolge mit Breitzeichen.Andernfalls verhalten sich diese Funktionen identisch.

Zuweisung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definieren	_UNICODE definiert
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul erwartet nptr , zu einer Zeichenfolge im folgenden Format zu veranschaulichen:

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

whitespace besteht möglicherweise Leerzeichen, Tabstoppzeichen und die ignoriert werden. digits sind eine oder mehrere Dezimalstellen.Das erste Zeichen, das nicht das Formular passt, beendet die Überprüfung.Wenn base zwischen 2 und 36 liegt, wird er als Basis der Zahl verwendet.Wenn base 0 (null) ist, werden die ersten Zeichen der Zeichenfolge, die von nptr gezeigte verwendet, um die Basis zu bestimmen.Wenn das erste Zeichen 0 ist und das zweite Zeichen „x“ oder „X“ ist, wird die Zeichenfolge als oktale ganze Zahl interpretiert. Andernfalls wird sie als decimal interpretiert.Wenn das erste Zeichen „0 " festgelegt ist, und das zweite Zeichen „x“ oder „X“ ist, wird die Zeichenfolge als ganze Hexadezimalzahl interpretiert.Wenn das erste Zeichen „1 " bis „9 " ist, wird die Zeichenfolge als ganze Dezimalzahl interpretiert.Der Buchstabe“ bis „z“ (oder „A“ durch „Z ") werden die Werte 10 und 35 zugewiesen. nur alphabetische Zeichen, deren bestimmte Werte kleiner sind als base sind zulässig.strtoul zulässig (plus einer+) oder Minuszeichen (präfixes; Zeichen)–ein führendes Minuszeichen gibt an, dass der Rückgabewert negiert wird.