Lee un conjunto de datos de un archivo de texto. ¡Esta función está obsoleta! En su lugar, utilice la función ReadTextData.
Sintaxis
ReadTextFile(TextFile, FromLine, ToLine, FromColumn, ToColumn, DataMatrix, DataType, Comma, ColumnSeparator [ , SingleSeparator = FALSE ])
La sintaxis de la función ReadTextFile 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. |
||||||||||||||||||||||||||||||
FromLine |
El número de la primera fila que se va a leer. Las estructuras de datos permitidas son Valor escalar. 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. |
||||||||||||||||||||||||||||||
ToLine |
El número de la última fila que se va a leer. Si ToLine es 0, se lee hasta el final del archivo. Las estructuras de datos permitidas son Valor escalar. 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. |
||||||||||||||||||||||||||||||
FromColumn |
El número de la primera columna que se va a leer. Las estructuras de datos permitidas son Valor escalar. 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. |
||||||||||||||||||||||||||||||
ToColumn |
El número de la última columna que se va a leer. Las estructuras de datos permitidas son Valor escalar. 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. |
||||||||||||||||||||||||||||||
DataMatrix |
Valor booleano que indica que el conjunto de datos debe leerse como matriz de datos. 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. |
||||||||||||||||||||||||||||||
DataType |
Especifica el tipo de datos en el que debe leerse el conjunto de datos. Para los datos en formato de tiempo del calendario o intervalo de tiempo, se especifica una cadena con formato de fecha con los siguientes caracteres:
El argumento DataType 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. |
||||||||||||||||||||||||||||||
Comma |
Valor booleano que indica que el separador decimal para números en coma flotante en el archivo es la coma ','. Si Comma es FALSE, la función espera un punto '.' como separador decimal. 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. |
||||||||||||||||||||||||||||||
ColumnSeparator |
Una cadena con los separadores de columna utilizados en el archivo de texto. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||||||||||||||||||||
SingleSeparator |
Un valor booleano. El valor TRUE indica que debe suponerse un cambio de columna después de cada separador de columnas. FALSE indica que solo se acepta un cambio de columna para separadores de columna consecutivos. 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. |
Notas
Los números en coma flotante pueden contener un exponente que empiece por la letra 'E' o 'e', por ejemplo 1.23e-12. 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. ReadTextFile puede leer series de datos y matrices de datos. Si lee varias columnas como una serie de datos, las columnas se añaden de izquierda a derecha.
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
ReadTextFile("c:\\examples\\file.txt", 2, 0, 2, 2, FALSE, TYPE_FLOATINGPOINT64, TRUE, "\t", FALSE)
Lee la segunda columna del archivo de texto c:\examples\file.txt. A partir de la segunda fila, el tabulador se utiliza como separador de columnas.