Freigeben über


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

CharNextExA-

CharPrev-

Konzeptionelle

Referenz-

Zeichenfolgen