CharPrevA-Funktion (winuser.h)

Artikel
11/20/2024

Ruft einen Zeiger auf das vorhergehende Zeichen in einer Zeichenfolge ab. Diese Funktion kann Zeichenfolgen verarbeiten, die aus ein- oder mehreren Bytezeichen bestehen.

Syntax

LPSTR CharPrevA(
  [in] LPCSTR lpszStart,
  [in] LPCSTR lpszCurrent
);

Parameter

[in] lpszStart

Typ: LPCTSTR-

Der Anfang der Zeichenfolge.

[in] lpszCurrent

Typ: LPCTSTR-

Ein Zeichen in einer mit Null beendeten Zeichenfolge.

Rückgabewert

Typ: LPTSTR-

Der Rückgabewert ist ein Zeiger auf das vorhergehende Zeichen in der Zeichenfolge oder auf das erste Zeichen in der Zeichenfolge, wenn der parameter lpszCurrent dem lpszStart-Parameter entspricht.

Bemerkungen

Wenn sie als ANSI-Funktion aufgerufen wird, verwendet CharPrev die Standardmäßigcodeseite des Systems, während CharPrevExA- 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 CharPrev als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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