System.SysUtils.TStringHelper.Compare

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi 

class function Compare(const StrA: string; const StrB: string): Integer; overload; static; inline;
class function Compare(const StrA: string; const StrB: string; LocaleID: TLocaleID): Integer; overload; static; inline;
class function Compare(const StrA: string; const StrB: string; IgnoreCase: Boolean): Integer; overload; static; inline; //deprecated 'Use same with TCompareOptions';
class function Compare(const StrA: string; const StrB: string; IgnoreCase: Boolean; LocaleID: TLocaleID): Integer; overload; static; inline; //deprecated 'Use same with TCompareOptions';
class function Compare(const StrA: string; const StrB: string; Options: TCompareOptions): Integer; overload; static; inline;
class function Compare(const StrA: string; const StrB: string; Options: TCompareOptions; LocaleID: TLocaleID): Integer; overload; static; inline;
class function Compare(const StrA: string; IndexA: Integer; const StrB: string; IndexB: Integer; Length: Integer): Integer; overload; static; inline;
class function Compare(const StrA: string; IndexA: Integer; const StrB: string; IndexB: Integer; Length: Integer; LocaleID: TLocaleID): Integer; overload; static; inline;
class function Compare(const StrA: string; IndexA: Integer; const StrB: string; IndexB: Integer; Length: Integer; IgnoreCase: Boolean): Integer; overload; static; inline; //deprecated 'Use same with TCompareOptions';
class function Compare(const StrA: string; IndexA: Integer; const StrB: string; IndexB: Integer; Length: Integer; IgnoreCase: Boolean; LocaleID: TLocaleID): Integer; overload; static; inline; //deprecated 'Use same with TCompareOptions';
class function Compare(const StrA: string; IndexA: Integer; const StrB: string; IndexB: Integer; Length: Integer; Options: TCompareOptions): Integer; overload; static; inline;
class function Compare(const StrA: string; IndexA: Integer; const StrB: string; IndexB: Integer; Length: Integer; Options: TCompareOptions; LocaleID: TLocaleID): Integer; overload; static; inline;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public System.SysUtils.pas System.SysUtils TStringHelper


Beschreibung

Vergleicht zwei 0-basierte Strings auf Gleichheit.

Compare ist eine statische Klassenfunktion (die Aufrufsyntax kann String.Compare(...); lauten) und gibt Folgendes zurück:

  • < 0, wenn StrA vor StrB kommt
  • 0, wenn StrA gleich StrB ist
  • > 0, wenn StrA nach StrB kommt
var
  MyStringA, MyStringB: String;

begin
  MyStringA := 'String A';
  MyStringB := 'String B';

  Writeln(Boolean(String.Compare(MyStringA, MyStringB) = 0));
end.

Ausgabe: 


FALSE

Es gibt acht überladene Compare-Methoden:

  • Die erste überladene Compare-Methode vergleicht StrA mit StrB unter Berücksichtigung der Groß-/Kleinschreibung.
  • Die zweite überladene Compare-Methode vergleicht StrA mit StrB unter dem im Parameter LocaleID angegebenen Sprach- und Regionsbezeichner. Diese Methode berücksichtigt die Groß-/Kleinschreibung.
  • Die dritte überladene Compare-Methode vergleicht StrA mit StrB unter im Parameter IgnoreCase angebbarer Nicht-Berücksichtigung der Groß-/Kleinschreibung.
  • Die vierte überladene Compare-Methode vergleicht StrA mit StrB unter im Parameter IgnoreCase angebbarer Nicht-Berücksichtigung der Groß-/Kleinschreibung und unter dem im Parameter LocaleID angegebenen Sprach- und Regionsbezeichner.
  • Die fünfte überladene Compare-Methode vergleicht StrA mit StrB und ermöglicht die Angabe der Position in den Strings (IndexA mit IndexB), ab der der Vergleich beginnen soll, sowie die Anzahl der zu vergleichenden Zeichen (Length). Diese Methode berücksichtigt die Groß-/Kleinschreibung.
  • Die sechste überladene Compare-Methode vergleicht StrA mit StrB und ermöglicht die Angabe der Position in den Strings (IndexA mit IndexB), ab der der Vergleich beginnen soll, sowie die Anzahl der zu vergleichenden Zeichen (Length). Bei dieser Methode können Sie im Parameter LocaleID auch den Sprach- und Regionsbezeichner angeben. Diese Methode berücksichtigt die Groß-/Kleinschreibung.
  • Die siebte überladene Compare-Methode vergleicht StrA mit StrB und ermöglicht die Angabe der Position in den Strings (IndexA mit IndexB), ab der der Vergleich beginnen soll, sowie die Anzahl der zu vergleichenden Zeichen (Length). Bei dieser Methode können Sie im Parameter IgnoreCase festlegen, ob die Groß-/Kleinschreibung berücksichtigt werden soll.
  • Die achte überladene Compare-Methode vergleicht StrA mit StrB und ermöglicht die Angabe der Position in den Strings (IndexA mit IndexB), ab der der Vergleich beginnen soll, sowie die Anzahl der zu vergleichenden Zeichen (Length). Bei dieser Methode können Sie im Parameter IgnoreCase festlegen, ob die Groß-/Kleinschreibung berücksichtigt werden soll, sowie im Parameter LocaleID den Sprach- und Regionsbezeichner angeben.

Hinweis: Unter bestimmten Umständen kann Compare auf älteren Versionen von Windows (vor Windows 7) fehlschlagen. Zum Beispiel kann es zu einem Fehlschlagen kommen, wenn ein String einen Bindestrich ("-") enthält oder wenn für System.SysUtils.TCompareOption coLingIgnoreCase oder coDigitAsNumbers festgelegt ist.

Hinweis: Unter bestimmten Umständen kann Compare auf älteren Versionen von Windows (vor Windows 7) fehlschlagen. Zum Beispiel kann es zu einem Fehlschlagen kommen, wenn ein String einen Bindestrich ("-") enthält oder wenn für System.SysUtils.TCompareOption coLingIgnoreCase oder coDigitAsNumbers festgelegt ist.

Siehe auch

Abgerufen von „http://docwiki.embarcadero.com/Libraries/Seattle/d/index.php?title=System.SysUtils.TStringHelper.Compare&oldid=680358“