System.Classes.TStrings.Append

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Append(const S: string);

C++

void __fastcall Append(const System::UnicodeString S);

Propriétés

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

Description

Ajoute une chaîne à la liste.

La méthode Append est identique à la méthode Add, mais elle ne renvoie pas de valeur. Utilisez Append quand il n'est pas utile de connaître l'indice de la nouvelle chaîne ou avec un descendant de TStrings pour lequel l'indice renvoyé est dépourvu de sens.

Par exemple, le descendant de TStrings utilisé par les objets mémo utilise un indice pour déterminer où insérer une chaîne, mais la chaîne insérée ne constitue pas nécessairement une seule chaîne de la liste. Une partie de la chaîne insérée peut devenir une partie de la chaîne précédente et le reste peut être attribué à la chaîne suivante. Dans un tel cas, l'indice renvoyé par Add est dépourvu de sens.

Mieux vaut utiliser Append plutôt que Add comme paramètre d'une fonction attendant le type TGetStrProc.

Voir aussi

Exemples de code