System.Classes.ExtractStrings
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.