|
|
|
|
|
|
|
|
 Advertencia
La función HImportText_55 es equivalente a la función HImportText disponible en WINDEV 5.5. Esta función se mantiene para la compatibilidad con versiones anteriores (esta función seguirá siendo soportada en la próxima versión). En la versión 8, la función HImportText ha evolucionado y ahora permite gestionar el resultado de una función de manera más fácil. Para beneficiarse de estas nuevas características, utilice la nueva sintaxis de HImportText. La documentación disponible en WINDEV 5.5 es la siguiente. Atención: los nombres de las variables han cambiado.
| Propósito Importar un archivo de texto a un archivo Hyper File. Sintaxis <CódigoError> = HImportTexte_55(<NombreArchivoLógicoHF> , <NombreArchivoTexto> [ , <ListaElementos> [ , <Separadores> [ , <ModoImportación> [ , <HandleVentana> ]]]])- <ErrorCode> es un número entero que indica el resultado de la importación (0 si es correcto)
- <LogicalNameHFFile> es una cadena de caracteres que corresponde al nombre lógico del archivo Hyper File (destino de la importación).
- <NameTextFile> es una cadena de caracteres que corresponde al nombre del archivo de texto a importar, con su ruta completa.
- <ItemList> es una cadena de caracteres que especifica la lista de elementos del archivo Hyper File que se encuentra en el archivo de texto.
- <Separadores> es una cadena de caracteres utilizada para definir los diferentes separadores (separador de columnas, separador de fila y delimitador de cadenas).
- <ImportMode> es un número entero utilizado para definir las características de la importación (ver Detalles).
- <WindowHandle> es un entero largo que contiene el manipular de la ventana que recibe la barra de progreso o NULL si no hay barra de progreso.
Detalles HImportText_55 se utiliza para importar el contenido de un archivo de texto en un archivo Hyper File, previamente descrito en la editor de análisis.
<ItemList> se utiliza para especificar los elementos del archivo <LogicalNameHFFile> a importar.. Este parámetro tiene el siguiente formato:
"<NameItem1> , <NameItem2> , <NameItem3>, ...., <NameItemN>"
En el archivo de texto a importar, cada registro corresponde a un "fila" y cada elemento corresponde a una "columna"..
Los separadores por defecto son:- la coma para las columnas
- la cita doble ( ") para las cadenas
- CR (Retorno de carro) para las líneas.
<Separator> se utiliza para modificar los separadores por defecto. Este parámetro tiene el siguiente formato:
<Separador de Columnas> + Char(127) + <Delimitador de Cadenas> + Char(127) + <Separador de Filas>
Atención: el delimitador de cadena está limitado a un carácter.
Ejemplo: Si las columnas están separadas por una tabulación (TAB) en el archivo de texto, <Separator> = TAB+ Char(127)+" " " " "+ Char(127)+CR
Las características de la importación están dadas por <ImportMode>.. Este parámetro corresponde a una de las constantes (o a una combinación de las siguientes constantes: | | | hImpNormal | Añadir los registros importados al archivo existente (.FIC) (valor por defecto) | | hImpCreación | Crear el archivo donde se añadirán los registros (si el archivo ".Fic" ya existe, se sobrescribe) | | hImpOEM2ANSI | Convertir las cadenas importadas de OEM a ANSI | | hImpTestDuplicados | Comprobar los duplicados durante la importación | | hImpTestIntegridad | Comprobar la integridad durante la importación | | hImpNoDelimitador | Los delimitadores de cadenas se ignoran |
Observaciones:- hImpNoDelimiter se utiliza para considerar el separador de columnas como delimitador de cadenas.
- Importación de un fila sin delimitador de cadena:
El fila en el archivo de texto es el siguiente: Montgomery,John,34000,Montpellier
El registro correspondiente en el archivo Hyper File será:- Apellido: Martín
- Nombre: Juan
- ZCode: 34000
- Ciudad Montpellier
- Importación de un fila con delimitador de cadena:
El fila en el archivo de texto es el siguiente: "Montgomery","John, Peter","34000","Montpellier".
El registro correspondiente en el archivo Hyper File será:- Apellido: Martín
- Nombre: John, Peter
- ZCode: 34000
- Ciudad Montpellier
- Los diferentes <códigos de error> devueltos por HImportText son los siguientes:
- 0: Importación finalizada
- 1: error en la asignación de la estructura de importación
- 2: error inicialización HF
- 3: archivo desconocido
- 4: archivo de texto no encontrado
- 5: modo no válido
- 6: lista de artículos no válida
- 7: abrir el archivo HF
- 8: abrir el archivo de texto
- 9: se ha alcanzado el fin del archivo
- 10: Asignación de la memoria intermedia de lectura
- 11: cadena inválida
- 12: error al recuperar una columna
- 13: error al transferir una columna a una posición HF
- 14: fila inválida
Notas - Se admiten los siguientes tipos de elementos Hyper File:
- Personajes,
- Entero corto sin signo en 1 byte
- Entero con y sin signo en 16 bits
- Entero con signo en 32 bits
- Real simple en 32 bits
- Real en formato TurboPascal
- Doble real en 64 bits
- Tipo de moneda (en 10 bytes)
- String:
- dinámico (hasta 64k)
- relleno con espacios
- precedido por su longitud
- terminado en 0
- Los elementos de array no están soportados
- Esta función sólo afecta a los archivos Hyper File.
|
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|