CharPrevA-Funktion (winuser.h)

Artikel
08/27/2023

Ruft einen Zeiger auf das vorherige Zeichen in einer Zeichenfolge ab. Diese Funktion kann Zeichenfolgen verarbeiten, die entweder aus Einzel- oder Mehrbytezeichen 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 NULL-beendeten Zeichenfolge.

Rückgabewert

Typ: LPTSTR

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

Hinweise

Beim Aufruf als ANSI-Funktion verwendet CharPrev die Standardcodepage des Systems, während CharPrevExA eine zu verwendende Codepage angibt.

Diese Funktion funktioniert mit den standardmäßigen Erwartungen des "Benutzers" an Zeichen, wenn es um diakritische Elemente 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 zu fünf Codepunkten, nicht eins usw.

Hinweis

Der winuser.h-Header definiert CharPrev 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll