System.Classes.TStringList.Add

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function Add(const S: string): Integer; override;

C++

virtual int __fastcall Add(const System::UnicodeString S);

Propriétés

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

Description

Add ajoute une nouvelle chaîne à la liste.

La méthode Add permet d'ajouter la chaîne S à la liste. Si la liste est triée, S est ajoutée à la position appropriée dans l'ordre de tri. Si la liste n'est pas triée, S est ajoutée en fin de liste. Add renvoie la position de l'élément dans la liste, le premier élément ayant la position 0.

Remarque :  Dans le cas d'une liste triée, Add déclenche une exception EListError si la chaîne S existe déjà dans la liste alors que Duplicates a la valeur dupError. Si Duplicates a la valeur dupIgnore, une tentative d'ajout d'une chaîne dupliquée provoque le renvoi par la méthode Add de l'indice de l'entrée existante.

Voir aussi