_atoi64, _wtoi64

Nach oben zu Stdlib.h - Index

Header-Datei

stdlib.h

Kategorie

Konvertierungsroutinen, mathematische Routinen

Prototyp

__int64 _atoi64(const char *s);
__int64 _wtoi64(const wchar_t *s);

Beschreibung

Konvertiert einen String in einen __int64-Wert.

Der String muss folgender Syntax entsprechen:

__int64 ::= [isspace]* [sign] digit [digit]*

Akzeptiert werden nur dezimale Integer.

_wtoi64 ist die Multibyte-Version dieser Funktion. Sie konvertiert einen String aus Multibyte-Zeichen in einen __int64-Wert.

Die Funktion beendet die Konvertierung beim ersten nicht erkannten Zeichen. atoi trifft keine Vorkehrungen gegen einen Überlauf (die Ergebnisse sind nicht definiert). Es gibt keine definierte Methode, dem Aufrufer das Vorliegen eines Fehlers anzuzeigen. Das Ergebnis ist nicht definiert, wenn der Eingabe-String ungültig ist.

Rückgabewert

Gibt den konvertierten Wert des Eingabe-Strings zurück. Kann der String nicht in einen Wert des Typs __int64 konvertiert werden kann, ist der Rückgabewert 0.

Beispiel

#include <stdlib.h>
#include <math.h>
__int64 add_inputs(wchar_t* left, wchar_t* right)
{
  /* Transform the input strings into __int64 */
  __int64 d_left = _wtoi64(left);
  __int64 d_right = _wtoi64(right);

  /* Add the transformed __int64 values */
  return d_left + d_right;
}

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
_atoi64		+
_wtoi64		+