CharNextA-Funktion (winuser.h)

Ruft einen Zeiger auf das nächste Zeichen in einer Zeichenfolge ab. Diese Funktion kann Zeichenfolgen verarbeiten, die entweder aus Einzel- oder Multibytezeichen bestehen.

Syntax

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

Parameter

[in] lpsz

Typ: LPCTSTR

Ein Zeichen in einer Zeichenfolge mit NULL-Beendigung.

Rückgabewert

Typ: LPTSTR

Der Rückgabewert ist ein Zeiger auf das nächste Zeichen in der Zeichenfolge oder auf das abschließende NULL-Zeichen, wenn am Ende der Zeichenfolge.

Wenn lpsz auf das abschließende NULL-Zeichen zeigt, ist der Rückgabewert gleich lpsz.

Hinweise

Wenn CharNext als ANSI-Funktion aufgerufen wird, verwendet CharNext die Standardcodepage des Systems, während CharNextExA eine zu verwendende Codepage angibt.

Diese Funktion funktioniert mit standardmäßigen "Benutzer"-Erwartungen an Zeichen, wenn es um diakritische Zeichen geht. Beispiel: Eine Zeichenfolge, die U+0061 U+030a "LATIN SMALL LETTER A" + COMBINING RING ABOVE" enthält – die wie "å" aussieht, führt zwei Codepunkte voran, nicht einen. Eine Zeichenfolge, die U+0061 U+0301 U+0302 U+0303 U+0304 enthält, die wie "a'^~ ̄" aussieht, führt fünf Codepunkte voran, nicht einer usw.

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll

Weitere Informationen

CharNextExA

CharPrev

Konzept

Referenz

Zeichenfolgen