CHString::SpanIncluding-Methode (chstring.h)

[Die Klasse CHString ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die SpanIncluding-Methode extrahiert Zeichen einer Zeichenfolge, die von lpszCharSet identifiziert werden.

Syntax

CHString  throw(CHeap_Exception) SpanIncluding(
  LPCWSTR lpszCharSet
);

Parameter

lpszCharSet

Eine Zeichenfolge, die als Satz von Zeichen interpretiert wird.

Rückgabewert

Die SpanIncluding-Methode gibt eine Teilzeichenfolge zurück, die Zeichen in der Zeichenfolge enthält, die sich in lpszCharSet befinden.

Wenn das erste Zeichen in der Zeichenfolge nicht im angegebenen Satz enthalten ist, gibt die Methode eine leere Teilzeichenfolge zurück.

Hinweise

Die SpanIncluding-Methode beginnt mit dem ersten Zeichen der Zeichenfolge und wird beendet, wenn ein Zeichen in der Zeichenfolge, aber nicht in lpszCharSet gefunden wird.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung von CHString::SpanIncluding.

CHString str( L"cabbage" );
CHString res = str.SpanIncluding( L"abc" );

assert( res == L"cabba" );
res = str.SpanIncluding( L"xyz" );
assert( res.IsEmpty( ) );

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	chstring.h (einschließlich FwCommon.h)
Bibliothek	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

Weitere Informationen

CHString

CHString::IsEmpty

CHString::SpanExcluding