System.SysUtils.TStringHelper.Compare

De RAD Studio API Documentation
Aller à : navigation, rechercher

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;

Propriétés

Type Visibilité  Source Unité  Parent
function public System.SysUtils.pas System.SysUtils TStringHelper


Description

Compare deux chaînes basées sur zéro pour déterminer si elles sont égales.

Compare est une fonction de classe statique (la syntaxe d'appel peut être String.Compare(...);) qui renvoie :

  • < 0 si StrA effectue un tri avant StrB
  • 0 si StrA est identique à StrB
  • > 0 si StrA effectue un tri après StrB
var
  MyStringA, MyStringB: String;

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

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

Sortie : 


FALSE

Il existe huit méthodes Compare surchargées :

  • La première méthode Compare surchargée compare StrA à StrB en tenant compte de la casse.
  • La seconde méthode Compare surchargée compare StrA à StrB avec la langue spécifiée et l'identificateur de région via le paramètre LocaleID. Cette méthode est sensible à la casse.
  • La troisième méthode Compare surchargée compare StrA à StrB avec la distinction majuscule/minuscule spécifiée via le paramètre IgnoreCase.
  • La quatrième méthode Compare surchargée compare StrA à StrB avec la distinction majuscule/minuscule spécifiée via le paramètre IgnoreCase et la langue et l'identificateur de région défini via le paramètre LocaleID.
  • La cinquième méthode Compare surchargée compare StrA à StrB et vous permet de spécifier à partir de quelle position dans les chaînes (IndexA contre IndexB) démarrer la comparaison, et sur quel nombre de caractères (Length). Cette méthode est sensible à la casse.
  • La sixième méthode Compare surchargée compare StrA à StrB et vous permet de spécifier à partir de quelle position dans les chaînes (IndexA contre IndexB) démarrer la comparaison, et sur quel nombre de caractères (Length). Cette méthode vous permet aussi de spécifier la langue et l'identificateur de région via le paramètre LocaleID. Cette méthode est sensible à la casse.
  • La sixième méthode Compare surchargée compare StrA à StrB et vous permet de spécifier à partir de quelle position dans les chaînes (IndexA contre IndexB) démarrer la comparaison, et sur quel nombre de caractères (Length). Cette méthode effectue la distinction majuscule/minuscule selon la spécification de l'utilisateur via le paramètre IgnoreCase.
  • La huitième méthode Compare surchargée compare StrA à StrB et vous permet de spécifier à partir de quelle position dans les chaînes (IndexA contre IndexB) démarrer la comparaison, et sur quel nombre de caractères (Length). Cette méthode effectue la distinction majuscule/minuscule selon la spécification de l'utilisateur via le paramètre IgnoreCase. Cette méthode vous permet aussi de spécifier la langue et l'identificateur de région via le paramètre LocaleID.

Remarque : Dans certaines circonstances, Compare peut échouer de façon inattendue sur des versions anciennes de Windows (antérieures à Windows 7). Par exemple, l'échec peut survenir si une chaîne contient un tiret ("-") ou dans le cas où System.SysUtils.TCompareOption coLingIgnoreCase ou coDigitAsNumbers est défini.

Remarque : Dans certaines circonstances, Compare peut échouer de façon inattendue sur des versions anciennes de Windows (antérieures à Windows 7). Par exemple, l'échec peut survenir si une chaîne contient un tiret ("-") ou dans le cas où System.SysUtils.TCompareOption coLingIgnoreCase ou coDigitAsNumbers est défini.

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/Libraries/Berlin/f/index.php?title=System.SysUtils.TStringHelper.Compare&oldid=640725 »