FileReadFields()
- Last UpdatedSep 24, 2024
- 2 minute read
Lit les valeurs contenues dans un fichier CSV dans une suite de variables. Vous pouvez utiliser cette fonction pour charger en bloc les valeurs d'une sélection de variables.
Le seul séparateur accepté est la virgule.
Cette fonction ne peut être utilisée que pour des appels synchrones.
Syntaxe
[result = ] FileReadFields (filename, offset, starttag, numberoffields)
Paramètres
nomFichier
Nom du fichier CSV dans lequel les données sont lues. Valeur chaîne littérale, variable message ou expression chaîne.
offset
Position du fichier (en octets) où débuter la lecture. Valeur entière littérale, variable entière ou expression de type entier.
starttag
Nom de la première variable qui reçoit les premières données lues. La variable doit être placée entre doubles guillemets et terminée par un nombre, par exemple «<:hs>MyTag1<:hs>». Chaîne littérale, variable message (par exemple une variable message contenant la valeur «<:hs>MyTag1<:hs>»), ou expression chaîne.
numberoffields
Nombre d'éléments à lire du fichier CSV. Valeur entière littérale, variable entière ou expression de type entier. Le premier élément de données est lu dans la variable désignée par le paramètre starttag, et les éléments suivants dans les variables désignées après incrément du suffixe numérique (MyTag1, MyTag2, MyTag3,...).
Valeur retour
Nouvelle position facultative du fichier (en octets) après lecture des données. Cette position peut être utilisée pour lire la sélection de données suivante.
Exemple(s)
Ce script lira les valeurs " Etage " dans RecipeTag1 ; 27,23 dans RecipeTag2 ; 14 dans RecipeTag3 ; et 1 dans RecipeTag4, et renverra la nouvelle position dans le fichier — en supposant que le fichier c:\set.csv contient les données suivantes : " Etage, 27.23,14,1 " et que les variables ont été définies de la manière suivante : RecipeTag1:message, RecipeTag2:real, Recipe3:integer, RecipeTag4:discrete.
FileReadFields("c:\set.csv",0,"RecipeTag1",4);