Format SCSVText dans une TStrings
| TStrings = class (TObject) | Interface de TStrings | Exemples de TStrings |
Voici les grands principes appliqués pour le format SCSVText des TStrings :
- Cette propriété permet de définir ou d'obtenir toutes les chaînes de l'objet TStrings dans une seule chaîne délimitée par des point-virgules.
En récupérant SCSVText, toute chaîne de la liste contenant des point-virgules est placée entre guillemets; les guillemets à l'intérieur des chaînes sont répétés.
Par exemple, si la liste contient les chaînes suivantes :
Chai;ne1
Chai"ne2
Chaine 3
Chaine4
SCSVText renvoie
"Chai;ne1",Chai""ne2,Chaine 3,Chaine4 - Lorsqu'une valeur est affectée à SCSVText, la valeur est analysée comme une chaîne dont les chaînes sont séparées par des point-virgules ou des retours à la ligne et, de manière facultative, mises entre guillemets. Les guillemets placés à l'intérieur des chaînes sont répétés afin de les distinguer des guillemets encadrant les chaînes. Les point-virgules ne se trouvant pas entre des guillemets sont des délimiteurs. Deux point-virgules successifs indiquent une chaîne vide, alors que des espaces à côté d'un délimiteur ne sont pas pris en compte.
Si, par exemple, la valeur suivante est affectée à SCSVText :
Chai,ne1; "Chai""ne2"; Chaine 3; "Chaine;4"
la liste contient alors
Chai,ne1
Chai"ne2
Chaine 3
Chaine;4
- L'ajout d'un point-virgule à la fin de la chaîne source provoque l'inclusion d'un élément vide dans la liste de chaînes. Par exemple, si SCSVText est définie par :
'Chaine1; Chaine2; Chaine3; '
la liste de chaînes contiendra
Chaine1
Chaine2
Chaine3
<vide>