CharNextA-Funktion (winuser.h)
Ruft einen Zeiger auf das nächste Zeichen in einer Zeichenfolge ab. Diese Funktion kann Zeichenfolgen verarbeiten, die aus ein- oder mehreren Bytezeichen bestehen.
Syntax
LPSTR CharNextA(
[in] LPCSTR lpsz
);
Parameter
[in] lpsz
Typ: LPCTSTR-
Ein Zeichen in einer mit Null beendeten Zeichenfolge.
Rückgabewert
Typ: LPTSTR-
Der Rückgabewert ist ein Zeiger auf das nächste Zeichen in der Zeichenfolge oder auf das endende Nullzeichen, wenn am Ende der Zeichenfolge.
Wenn lpsz auf das endende Nullzeichen zeigt, entspricht der Rückgabewert lpsz.
Bemerkungen
Wenn sie als ANSI-Funktion aufgerufen wird, verwendet CharNext die Standardcodeseite des Systems, während CharNextExA- eine zu verwendende Codeseite angibt.
Diese Funktion funktioniert mit standardmäßigen "Benutzer"-Erwartungen von Zeichen beim Umgang mit diakritischen Zeichen. Beispiel: Eine Zeichenfolge mit U+0061 U+030a "LATIN SMALL LETTER A" + COMBINING RING ABOVE" – die wie "å" aussieht, wird zwei Codepunkte voranstellen, nicht eine. Eine Zeichenfolge mit U+0061 U+0301 U+0302 U+0303 U+0304 – die wie "a'^~ ̄" aussieht, wird fünf Codepunkte, nicht eins usw. voranstellen.
Anmerkung
Der winuser.h-Header definiert CharNext als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | winuser.h (enthalten Windows.h) |
Library | User32.lib |
DLL- | User32.dll |
Siehe auch
Konzeptionelle
Referenz-