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
Konzept
Referenz