ReadTextFile (FPScript)
Lit un ensemble de données à partir d'un fichier texte. C'est une fonction obsolète ! Utilisez la fonction
Syntaxe
ReadTextFile(TextFile, FromLine, ToLine, FromColumn, ToColumn, DataMatrix, DataType, Comma, ColumnSeparator [ , SingleSeparator = FALSE ])
La syntaxe de la fonction ReadTextFile se compose des éléments suivants :
Section |
Description |
||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
TextFile |
Chaîne de caractères avec le chemin du fichier texte à lire. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères (nom du fichier). Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||||||||||||||||||||
FromLine |
Numéro de la première ligne à lire. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
ToLine |
Numéro de la dernière ligne à lire. Si ToLine est égal à 0, le fichier est lu jusqu'à la fin. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
FromColumn |
Numéro de la première colonne à lire. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
ToColumn |
Numéro de la dernière colonne à lire. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
DataMatrix |
Valeur booléenne, qui spécifie que l'ensemble de données doit être lu comme une matrice de données. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
DataType |
Précise le type de données dans lequel l'ensemble de données doit être lu. Pour les données au format temps calendaire ou période de temps, une chaîne de caractère au format de la date est spécifiée à l'aide des caractères suivants :
L'argument DataType peut avoir les valeurs suivantes :
Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
Comma |
Une valeur booléenne, qui spécifie que la virgule ',' est le séparateur décimal pour les valeurs à virgule flottante dans le fichier. Si Comma est égal à FALSE, alors la fonction attend un point "." comme séparateur décimal. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
ColumnSeparator |
Une chaîne de caractère avec les caractères de séparation des colonnes utilisés dans le fichier texte. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||
SingleSeparator |
Une valeur booléenne. La valeur TRUE précise qu'après chaque séparateur de colonne, il faut supposer un changement de colonne. FALSE précise qu'avec les séparateurs de colonnes suivants, on ne doit supposer qu'un seul changement de colonnes. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut FALSE . |
Remarques
Les valeurs à virgule flottante peuvent contenir un exposant, qui doit commencer par la lettre "E" ou "e", par exemple, 1,23e-12. Si une entrée dans le fichier ne peut pas être interprétée comme un nombre, alors une valeur à virgule flottante invalide (void) est saisie à l'emplacement correspondant dans le résultat. ReadTextFile peut lire des séries de données et des matrices de données. Si vous lisez plusieurs colonnes comme une série de données, les colonnes sont annexées les unes aux autres, de gauche à droite.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
ReadTextFile("c:\\examples\\file.txt", 2, 0, 2, 2, FALSE, TYPE_FLOATINGPOINT64, TRUE, "\t", FALSE)
Lit la deuxième colonne du fichier texte c:\examples\file.txt. Commence à la deuxième ligne, et des tabulations sont utilisées pour le séparateur de colonnes.