System.Classes.ExtractStrings

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function ExtractStrings(Separators, WhiteSpace: TSysCharSet; Content: PChar; Strings: TStrings): Integer;

C++

extern DELPHI_PACKAGE int __fastcall ExtractStrings(const System::Sysutils::TSysCharSet &Separators, const System::Sysutils::TSysCharSet &WhiteSpace, System::WideChar * Content, TStrings* Strings);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Classes.pas
System.Classes.hpp
System.Classes System.Classes

Description

Remplit une liste de chaînes avec des sous-chaînes analysées depuis une liste délimitée.

Utilisez ExtractStrings pour remplir une liste de chaînes avec les sous-chaînes de la chaîne terminée par le caractère Null spécifiée par Content.

Separators définit un ensemble de caractères utilisés comme délimiteurs, séparant les sous-chaînes. Les retours chariot, les caractères de passage à la ligne et les guillemets (simples ou doubles) sont toujours traités comme des séparateurs. Lorsqu'ils se trouvent à l'intérieur d'une chaîne entre guillemets, les séparateurs sont ignorés jusqu'au guillemet de fermeture. Sachez toutefois que les guillemets peuvent apparaître dans une chaîne guillemetée si le guillemet est double.

WhiteSpace définit un ensemble de caractères devant être ignorés lors de l'analyse de Content s'ils se trouvent au début d'une chaîne.

Content est la chaîne de caractères terminée par le caractère Null à convertir en plusieurs sous-chaînes.

Strings est une liste de chaînes à laquelle toutes les sous-chaînes analysées depuis Content sont ajoutées. La liste de chaînes n'est pas effacée par ExtractStrings, de sorte que toutes les chaînes se trouvant déjà dans la liste de chaînes sont préservées.

ExtractStrings renvoie le nombre de chaînes ajoutées au paramètre Strings.

Remarque :  ExtractStrings n'ajoute aucune chaîne vide à la liste.

Voir aussi