Lit un ou plusieurs ensembles de données à partir d'un fichier texte.
Syntaxe
ReadTextData(TextFile, le [ Schema ], le [ ChannelIdentifier ], le [ CalendarTime Variable FALSE ], le [ Signal Variable FALSE ], le [ DataRange Variable READDATAFILE_DR_COMPLETE ], le [ RangeFrom ], le [ RangeTo ] [ , le 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 à lire (commençant par 1) ou des canaux à lire. Si aucun numéro de canal n'est indiqué, tous les canaux sont retournés ou, s'ils existent, la sélection du schéma choisi est utilisée. Si une valeur individuelle est ChannelIdentifier est indiquée, le canal est renvoyé sous forme de série de données ou de signal. Sinon, les chaînes sont renvoyées sous forme de liste. Les structures de données autorisées sont Scalaire et Série 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 précisant que les données de temps doivent être lues comme des temps calendaire. 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 pour le format sélectionné et 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 précisant que les éléments doivent être importés sous forme de signaux. Cet argument peut ne pas être pris en charge pour le format sélectionné et 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 |
Heure absolue ou relative 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, un temps calendaire est attendu ici, sinon un nombre à virgule flottante. Si l'argument n'est pas donné ou si aucun enregistrement X n'est attribué aux enregistrements, les données sont lues à partir 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. Les valeurs invalides ne sont pas autorisées dans cet argument. 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 dernière valeur à lire, si les données ne doivent pas être lues jusqu'à la fin. Si l'ensemble de données X contient des valeurs de temps calendaire, un temps calendaire est attendu ici, sinon un nombre à virgule flottante. Si l'argument n'est pas donné ou si aucun enregistrement X n'est attribué aux enregistrements, 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. Les valeurs invalides ne sont pas autorisées dans cet argument. 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 indiquée si l'élément DataRange contient la valeur READTEXTDATA_DR_FROMDURATION, READTEXTDATA_DR_DURATIONLAST ou READTEXTDATA_DR_FIRSTDURATION a pour valeur Cet argument n'est pris en charge que si un enregistrement 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. Les valeurs invalides ne sont pas autorisées dans cet argument. 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é avec l'assistant d'importation de textiles, il est possible d'enregistrer le schéma avec les paramètres dans la base de données de modèles. Dans ce cas, vous pouvez accéder aux paramètres via l'alias. Si les paramètres ne sont pas enregistrés sous forme de schéma, vous pouvez également les transmettre directement à la fonction sous la forme d'une chaîne de caractères XML. Dans la boîte de dialogue Organiser, vous pouvez enregistrer un schéma sauvegardé dans un fichier XML. Dans la ReadTextData vous pouvez également accéder directement à un tel fichier XML. 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.