ReadTextData (FPScript)
Lit un ou plusieurs ensembles de données à partir d'un fichier texte.
Syntaxe
ReadTextData(TextFile, [ Schema ], [ ChannelIdentifier ], [ CalendarTime = FALSE ], [ Signal = FALSE ], [ DataRange = READDATAFILE_DR_COMPLETE ], [ RangeFrom ], [ RangeTo ] [ , Duration ])
La syntaxe de la fonction ReadTextData 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. |
||||||||||||
Schema |
Nom d'alias d'un schéma stocké dans la base de données projet qui contient tous les paramètres nécessaires à l'importation, ou le chemin d'un schéma XML stocké sur le disque dur, ou tous les paramètres nécessaires sous forme de chaîne XML. L'argument Schema 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é. |
||||||||||||
ChannelIdentifier |
Numéro du canal (commençant par 1) ou des canaux à lire. Si aucun numéro de canal n'est spécifié, tous les canaux sont retournés ou, s'ils sont présents, la sélection du schéma choisi est utilisée. Si une valeur scalaire est spécifiée en tant que ChannelIdentifier le canal est renvoyé sous forme de série de données ou de signal. Sinon, les canaux sont renvoyés sous forme de liste. Les structures de données autorisées sont Scalaire et Séries de données. 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é. |
||||||||||||
CalendarTime |
Valeur booléenne indiquant que les données temporelles doivent être lues en tant que temps calendaires. Sinon, la composante X fournit le temps en secondes depuis le début de la mesure. Cet argument peut ne pas être pris en charge par le format sélectionné et, dans ce cas, il peut être ignoré. 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 . |
||||||||||||
Signal |
Valeur booléenne spécifiant que les éléments doivent être lus comme des signaux. Cet argument peut ne pas être pris en charge par le format sélectionné et, dans ce cas, peut être ignoré. 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 . |
||||||||||||
DataRange |
Valeur qui spécifie le type de plage de données à créer. L'argument DataRange 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é. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut READDATAFILE_DR_COMPLETE . |
||||||||||||
RangeFrom |
Temps absolu ou relatif de la première valeur à lire si les données ne doivent pas être lues depuis le début. Si l'ensemble de données X contient des valeurs de temps calendaire, une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas spécifié ou si aucun ensemble de données X n'est affecté aux ensembles de données, les données sont lues depuis le début de la première valeur. Les structures de données autorisées sont Scalaire. Tous les types de données réels 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é. |
||||||||||||
RangeTo |
Temps absolu ou relatif de la première valeur à lire si les données ne sont pas lues jusqu'à la fin. Si l'ensemble de données X contient des valeurs de temps calendaire, une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas spécifié ou si aucun ensemble de données X n'est affecté aux ensembles de données, les données sont lues jusqu'à la dernière valeur. Les structures de données autorisées sont Scalaire. Tous les types de données réels 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é. |
||||||||||||
Duration |
Durée de la plage de données. Cette valeur doit être précisée si l'élément DataRange a la valeur READTEXTDATA_DR_FROMDURATION, READTEXTDATA_DR_DURATIONLAST ou READTEXTDATA_DR_FIRSTDURATION lorsqu'il est considéré comme un tout. Cet argument n'est pris en charge que si un ensemble de données X a été spécifié. Les structures de données autorisées sont Scalaire. Tous les types de données réels 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é. |
Remarques
Si un fichier est importé à l'aide de l'assistant d'importation de données textuelles, il est possible d'enregistrer le schéma avec les paramètres dans la base de données des modèles. Dans ce cas, le nom d'alias peut être utilisé pour accéder aux paramètres. Si les paramètres ne sont pas stockés sous forme de schéma, vous pouvez également transmettre les paramètres directement sous la forme d'une chaîne XML de la fonction. Vous pouvez enregistrer un schéma stocké dans un fichier XML dans la boîte de dialogue Organiser. Vous pouvez également accéder directement à ce type de fichier XML dans ReadTextData. Si une entrée du fichier ne peut pas être interprétée comme un nombre, alors une valeur à virgule flottante invalide est saisie à l'emplacement correspondant dans le résultat.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
ReadTextData("c:\\examples\\file.txt", "", 2)
Lit le deuxième canal à partir du fichier texte c:\examples\file.txt. Les paramètres par défaut sont utilisés pour l'importation.