Lee uno o varios conjuntos de datos de un archivo de texto.
Sintaxis
ReadTextData(TextFile, [ Schema ], [ ChannelIdentifier ], [ CalendarTime = FALSE ], [ Signal = FALSE ], [ DataRange = READDATAFILE_DR_COMPLETE ], [ RangeFrom ], [ RangeTo ] [ , Duration ])
La sintaxis de la función ReadTextData consta de los siguientes elementos:
Parte |
Descripción |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
TextFile |
Cadena con la ruta del archivo de texto que se va a leer. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena (nombre del archivo). Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||
Schema |
Alias de un esquema guardado en la base de datos del proyecto que contiene toda la configuración necesaria para la importación, o la ruta de un esquema XML guardado en el disco duro o toda la configuración necesaria como cadena XML. El argumento Schema puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
ChannelIdentifier |
El número del canal que se va a leer (empezando por 1) o de los canales que se van a leer. Si no se especifica ningún número de canal, se devuelven todos los canales o, si están disponibles, se utiliza la selección del esquema seleccionado. Si se especifica un valor escalar como ChannelIdentifier, el canal se devuelve como serie de datos o señal. En caso contrario, los canales se devuelven como lista. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos enteros. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
CalendarTime |
Valor booleano que especifica que la información de tiempo debe leerse como tiempo del calendario. De lo contrario, el componente X proporciona el tiempo en segundos desde el inicio de la medición. Este argumento puede no ser compatible con el formato seleccionado y, en caso necesario, puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado FALSE si no se especifica el argumento. |
||||||||||||
Signal |
Valor booleano que especifica que los elementos deben importarse como señales. Este argumento puede no ser compatible con el formato seleccionado y, en caso necesario, puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado FALSE si no se especifica el argumento. |
||||||||||||
DataRange |
Valor que especifica el tipo de rango de datos que se va a crear. El argumento DataRange puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado READDATAFILE_DR_COMPLETE si no se especifica el argumento. |
||||||||||||
RangeFrom |
Instante absoluto o relativo del primer valor que se va a leer si los datos no se van a leer desde el principio. Si el conjunto de datos X contiene valores de tiempo del calendario, aquí se espera un tiempo del calendario; en caso contrario, un número en coma flotante. Si no se especifica el argumento o no se asigna ningún conjunto de datos X a los conjuntos de datos, los datos se leen a partir del primer valor. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. No se permiten valores inválidos en este argumento. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
RangeTo |
Instante absoluto o relativo del último valor que se va a leer si los datos no se van a leer hasta el final. Si el conjunto de datos X contiene valores de tiempo del calendario, aquí se espera un tiempo del calendario; en caso contrario, un número en coma flotante. Si no se especifica el argumento o no se asigna ningún conjunto de datos X a los conjuntos de datos, los datos se leen a partir del primer valor. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. No se permiten valores inválidos en este argumento. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
Duration |
Duración del segmento de datos. Este valor debe especificarse si el elemento DataRange tiene el valor READTEXTDATA_DR_FROMDURATION, READTEXTDATA_DR_DURATIONLAST o READTEXTDATA_DR_FIRSTDURATION. Este argumento solo se admite si se ha especificado un conjunto de datos X. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. No se permiten valores inválidos en este argumento. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Notas
Si se importa un archivo mediante el asistente para la importación de datos de texto, es posible guardar el esquema con la configuración en la base de datos de plandetillas. En ese caso, puede acceder a la configuración a través del alias. Si la configuración no se guarda como esquema, también puede transferirla directamente a la función en forma de cadena XML. En el cuadro de diálogo Organizador, puede guardar un esquema almacenado en un archivo XML. En el ReadTextData también puede acceder directamente a dicho archivo XML. Si una entrada del archivo no puede interpretarse como un número, se introduce en el resultado un valor en coma flotante inválido en la posición correspondiente.
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
ReadTextData("c:\\examples\\file.txt", "", 2)
Lee el segundo canal del archivo de texto c:\examples\file.txt. Para la importación se utilizan los ajustes predeterminados.