zipExtractFile (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Functions for archive management

Extracción y contraseña

Índice de ficheros en el archivo

ruta almacenada

Extracción de un archivo de varias partes en disquetes

Barra de progreso

Ver también

Constantes para las funciones de archivo

Funciones de archivo (gestión de ZIP, WDZ, CAB, RAR, 7z, TAR y TGZ (TAR.GZ))

Los archivos

Los archivos de una y varias partes

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

Códigos de error
Archivo extraído
Extracción y contraseña
Índice de ficheros en el archivo
ruta almacenada
Extracción de un archivo de varias partes en disquetes
Barra de progreso

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

zipExtractFile (Función)

Extrae un archivo de un archivo comprimido y lo descomprime automáticamente en una ubicación física o en la memoria..

Versiones 15 y posteriores

Esta función ahora está disponible para aplicaciones Android.

Nueva funcionalidad versión 15

Esta función ahora está disponible para aplicaciones Android.

Versiones 17 y posteriores

Esta función ahora está disponible para aplicaciones iPhone/iPad.

Nueva funcionalidad versión 17

Esta función ahora está disponible para aplicaciones iPhone/iPad.

Versiones 18 y posteriores

Esta función ahora está disponible en modo Android Widget.

Esta función ahora soporta el formato 7z.

Nueva funcionalidad versión 18

Esta función ahora está disponible en modo Android Widget.

Esta función ahora soporta el formato 7z.

Esta función ahora está disponible en modo Android Widget.

Esta función ahora soporta el formato 7z.

Versiones 19 y posteriores

Esta función ahora está disponible en modo Windows Store apps.

Nueva funcionalidad versión 19

Esta función ahora está disponible en modo Windows Store apps.

Versiones 21 y posteriores

Esta función ahora está disponible en modo Universal Windows 10 App.

Esta función soporta ahora los formatos TAR y TGZ (TAR.GZ).

Nueva funcionalidad versión 21

Esta función ahora está disponible en modo Universal Windows 10 App.

Esta función soporta ahora los formatos TAR y TGZ (TAR.GZ).

Esta función ahora está disponible en modo Universal Windows 10 App.

Esta función soporta ahora los formatos TAR y TGZ (TAR.GZ).

Ejemplo

Archive is zipArchive
// Open an archive
ResOpenArchive = zipOpen(Archive, "C:\Archives\Archive.zip")
// In Windows Mobile:
// ResOpenArchive = zipOpen(Archive, "\Archives\Archive.zip")

IF ResOpenArchive = 0 THEN
...
// Extract a file to its initial location
ResExtractFile = zipExtractFile(Archive, "File.txt", zipDrive)
...
END

Sintaxis

Extrayendo un archivo identificado por su índice Ocultar los detalles

<Result> = zipExtractFile(<Archive> , <File subscript> [, <File destination> [, <Progress bar management>]])

<Result>: Entero o tampón

0 si el archivo fue extraído,
Un código de error (valor superior a 0) en caso contrario. Para más detalles sobre estos códigos de error, vea la Observaciones.
Al extraer "en memoria", corresponde al búfer que contiene el archivo extraído.

<Archive>: Cadena de caracteres (con citas) o zipArchivo variable

Nombre del archivo comprimido a utilizar.
Este nombre puede corresponder a:
un nombre de archivo, definido por zipOpen o por zipCreate.
Versiones 15 y posteriores
el nombre de una variable de tipo zipArchive.
Nueva funcionalidad versión 15
el nombre de una variable de tipo zipArchive.
el nombre de una variable de tipo zipArchive.

<File subscript>: Integro

Índice del fichero a extraer del archivo. Este índice es devuelto por zipFindFile.

<File destination>: Cadena de caracteres opcional o constante

Destino ruta del archivo extraído:
Cadena de caracteres opcional: El archivo se extrae a la ruta especificada a la que se añade la estructura de árbol del archivo almacenado (la unidad no se almacena).. Se crea la ruta especificada si no existe.
El destino ruta del archivo extraído debe corresponder al directorio de trabajo de la aplicación (devuelto por fDataDir) o a uno de sus subdirectorios.
Constante opcional:
zipNone Extracción en el directorio actual sin restaurar la estructura de árbol del archivo (si estaba almacenado).
zipDrive Extracción:
a la ubicación inicial del archivo si estaba almacenado y si la unidad existe.
mientras restaura la estructura de árbol del archivo en la unidad actual si la unidad o el directorio almacenado no existe.
en el directorio actual si sólo se han almacenado el nombre y la extensión del archivo.
Esta constante no está disponible. Los directorios no tienen raíz.
Esta constante y la constante zipDirectory tendrán el mismo efecto. Archivos en formato 7z: Esta constante y la constante zipDirectory tendrán el mismo efecto.
zipInMemoria Extrae el archivo de la memoria. El contenido del archivo es devuelto directamente por la función. Se puede asignar a una variable Buffer por ejemplo.
Esta característica está disponible sólo para los archivos ZIP y WDZ.
zipDirectorio
(Valor predeterminado) Extracción en el directorio actual mientras se restaura la estructura de árbol del archivo (si estaba almacenado).

Estas constantes no se pueden utilizar porque la noción de directorio actual no es soportada por el Pocket PC.
Estas constantes no se pueden utilizar.

<Progress bar management>: Cadena de caracteres opcional (con o sin comillas)

Versiones 21 y posteriores
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de archivos.
el nombre de un procedimiento WLanguage. Este procedimiento tiene el siguiente formato:

<Procedure name> (<Current file>, <Progress percentage>)

donde:
<El archivo actual> corresponde al nombre del archivo actualmente procesado..
<El porcentaje de progreso corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo..
Atención: La barra de progreso se actualiza al final de la extracción de archivos para los siguientes tipos de archivos comprimidos:
TAR o TGZ (TAR.GZ),
RAR,
CAB.
Nueva funcionalidad versión 21
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de archivos.
el nombre de un procedimiento WLanguage. Este procedimiento tiene el siguiente formato:

<Procedure name> (<Current file>, <Progress percentage>)

donde:
<El archivo actual> corresponde al nombre del archivo actualmente procesado..
<El porcentaje de progreso corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo..
Atención: La barra de progreso se actualiza al final de la extracción de archivos para los siguientes tipos de archivos comprimidos:
TAR o TGZ (TAR.GZ),
RAR,
CAB.
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de archivos.
el nombre de un procedimiento WLanguage. Este procedimiento tiene el siguiente formato:

<Procedure name> (<Current file>, <Progress percentage>)

donde:
<El archivo actual> corresponde al nombre del archivo actualmente procesado..
<El porcentaje de progreso corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo..
Atención: La barra de progreso se actualiza al final de la extracción de archivos para los siguientes tipos de archivos comprimidos:
TAR o TGZ (TAR.GZ),
RAR,
CAB.

Extrayendo un archivo identificado por su ruta Ocultar los detalles

<Result> = zipExtractFile(<Archive> , <File path> [, <File destination> [, <Progress bar management>]])

<Result>: Entero o tampón

0 si el archivo fue extraído,
Un código de error (valor superior a 0) en caso contrario. Para más detalles sobre estos códigos de error, vea la Observaciones.
Al extraer "en memoria", corresponde al búfer que contiene el archivo extraído.

<Archive>: Cadena de caracteres (con citas) o zipArchivo variable

Nombre del archivo comprimido a utilizar.
Este nombre puede corresponder a:
el nombre de un archivo, definido por zipOpen o zipCreate.
Versiones 15 y posteriores
el nombre de una variable de tipo zipArchive.
Nueva funcionalidad versión 15
el nombre de una variable de tipo zipArchive.
el nombre de una variable de tipo zipArchive.

<File path>: Cadena de caracteres (con comillas)

ruta almacenada del archivo a extraer del archivo. Realiza una búsqueda de coincidencias exactas en la ruta del archivo en el archivo.

<File destination>: Cadena de caracteres opcional o constante

Destino ruta del archivo extraído:
Cadena de caracteres opcional: El archivo se extrae a la ruta especificada a la que se añade la estructura de árbol del archivo almacenado (la unidad no se almacena).. Se crea la ruta especificada si no existe.
El destino ruta del archivo extraído debe corresponder al directorio de trabajo de la aplicación (devuelto por fDataDir) o a uno de sus subdirectorios.
Constante opcional:
zipNone Extracción en el directorio actual sin restaurar la estructura de árbol del archivo (si estaba almacenado).
zipDrive Extracción:
a la ubicación inicial del archivo si estaba almacenado y si la unidad existe.
mientras restaura la estructura de árbol del archivo en la unidad actual si la unidad o el directorio almacenado no existe.
en el directorio actual si sólo se han almacenado el nombre y la extensión del archivo.
Esta constante no está disponible. Los directorios no tienen raíz.
Esta constante y la constante zipDirectory tendrán el mismo efecto. Archivos en formato 7z: Esta constante y la constante zipDirectory tendrán el mismo efecto.
zipInMemoria Extrae el archivo de la memoria. El contenido del archivo es devuelto directamente por la función. Se puede asignar a una variable Buffer por ejemplo.
Esta característica está disponible sólo para los archivos ZIP y WDZ.
zipDirectorio
(Valor predeterminado) Extracción en el directorio actual mientras se restaura la estructura de árbol del archivo (si estaba almacenado).

Estas constantes no se pueden utilizar porque la noción de directorio actual no es soportada por el Pocket PC.
Estas constantes no se pueden utilizar.

<Progress bar management>: Cadena de caracteres opcional (con o sin comillas)

Versiones 21 y posteriores
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de archivos.
el nombre de un procedimiento WLanguage. Este procedimiento tiene el siguiente formato:

<Procedure name> (<Current file>, <Progress percentage>)

donde:
<El archivo actual> corresponde al nombre del archivo actualmente procesado..
<El porcentaje de progreso corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo..
Atención: La barra de progreso se actualiza al final de la extracción de archivos para los siguientes tipos de archivos comprimidos:
TAR o TGZ (TAR.GZ),
RAR,
CAB.
Nueva funcionalidad versión 21
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de archivos.
el nombre de un procedimiento WLanguage. Este procedimiento tiene el siguiente formato:

<Procedure name> (<Current file>, <Progress percentage>)

donde:
<El archivo actual> corresponde al nombre del archivo actualmente procesado..
<El porcentaje de progreso corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo..
Atención: La barra de progreso se actualiza al final de la extracción de archivos para los siguientes tipos de archivos comprimidos:
TAR o TGZ (TAR.GZ),
RAR,
CAB.
Modo de gestión de la barra de progreso. Este parámetro puede corresponder a:
el nombre de un control Barra de progreso encontrado en una ventana. La barra de progreso mostrará el progreso de la extracción de archivos.
el nombre de un procedimiento WLanguage. Este procedimiento tiene el siguiente formato:

<Procedure name> (<Current file>, <Progress percentage>)

donde:
<El archivo actual> corresponde al nombre del archivo actualmente procesado..
<El porcentaje de progreso corresponde al porcentaje de progreso del archivo que se está extrayendo del archivo..
Atención: La barra de progreso se actualiza al final de la extracción de archivos para los siguientes tipos de archivos comprimidos:
TAR o TGZ (TAR.GZ),
RAR,
CAB.

Observaciones

Códigos de error

Se devuelven los siguientes códigos de error:

1: El ruta pasado como parámetro no existe.
2: Acceso denegado: el usuario no tiene suficientes derechos.
3: El archivo está corrupto.
4: La ruta no existe en el archivo.
6: Los archivos de los subarchivos no están ordenados (cuando se extraen de un archivo de varias partes).
21: La contraseña especificada no es correcta.

El mensaje correspondiente al código de error es devuelto por zipMsgError. Recordatorio:

Sólo están disponibles los archivos en formato ZIP, TAR y TGZ (TAR.GZ).
Sólo están disponibles los archivos comprimidos en formato ZIP.

Archivo extraído

El archivo extraído no se elimina del archivo comprimido. Para borrar un archivo o todos los archivos del archivo, usa zipDeleteFile o zipDeleteAll.

Extracción y contraseña

Si el archivo no está encriptado y si se utilizó zipPassword:

Archivo en formato WDZ: El archivo se sigue extrayendo.
Archivo en formato ZIP: Se produce un error.

Índice de ficheros en el archivo

Cuando se añade un archivo a un archivo, se asigna automáticamente un índice al archivo.. Este índice corresponde al orden en el que se incluyen los ficheros en el archivo.. Para seleccionar un fichero en el archivo comprimido, puede utilizar:

el índice del elemento (el índice de un elemento es devuelto por zipFindFile).
el ruta almacenado del elemento.

ruta almacenada

A continuación, tabla presenta las rutas almacenadas en el archivo según:

el acceso ruta al fichero,
la sección ruta almacenada.

El directorio actual es: "C:\Temp".


zipAddFile	Ubicación del archivo	zipNone	zipDirectorio	zipDrive
zipAddFile("Archi",... "Archivo.txt")	C:\Temp\Archivo.txt	Archivo.txt	Archivo.txt	Archivo.txt
zipAddFile("Archi",... "Data\Archivo.txt")	C:\Temp\Data\Archivo.txt	Archivo.txt	Data\Archivo.txt	Data\Archivo.txt
zipAddFile("Archi",... "D:\Data\Archivo.txt")	D:\Data\Archivo.txt	Archivo.txt	Data\Archivo.txt	D:\Data\Archivo.txt

Observación: Si se utiliza la constante zipDrive:

el formato WDZ almacena la ruta completa del archivo (incluyendo la letra de la unidad).
el formato ZIP no almacena la letra de la unidad.
el formato 7z almacena sólo los directorios.

La constante zipDrive es equivale a la constante zipDirectory.

El directorio y el disco no se almacenan en el archivo ruta. Sólo se almacenan el nombre y la extensión del archivo.

A continuación, tabla presenta las rutas almacenadas en el archivo según:

el acceso ruta al fichero,
la sección ruta almacenada.


zipAddFile	Ubicación del archivo	zipNone	zipDirectorio
zipAddFile("Archi",... "_ASLASH_ Archivo.txt")	ASLASH_ Archivo.txt	Archivo.txt	Archivo.txt
zipAddFile("Archi",... "\Temp\Archivo.txt")	\Temp\Archivo.txt	Archivo.txt	Temp\Archivo.txt

Extracción de un archivo de varias partes en disquetes

Si los archivos a extraer se encuentran en disquetes diferentes, se solicita automáticamente el disquete correspondiente.. Para extraer varios ficheros de un archivo de varias partes, le aconsejamos que extraiga los ficheros según el orden de su índice en el archivo. Por lo tanto, los diferentes disquetes se solicitarán en orden ascendente.

Barra de progreso

En Windows, para ver el progreso de la extracción y descompresión de archivos, se debe relacionar un evento con el mensaje CompressProgressBar (1174).
Cuando se recibe este mensaje, la variable _EVE.wParam contiene el porcentaje de archivo ya descomprimido.

Versiones 21 y posteriores
A partir de la versión 21, <Manejo de la barra de progreso> también se puede utilizar para administrar el progreso de la adición de archivos..

Nueva funcionalidad versión 21
A partir de la versión 21, <Manejo de la barra de progreso> también se puede utilizar para administrar el progreso de la adición de archivos..

A partir de la versión 21, <Manejo de la barra de progreso> también se puede utilizar para administrar el progreso de la adición de archivos..

Clasificación Lógica de negocio / UI : Lógica de negocio

Componente : wd260zip.dll

Ver también

Versión mínima requerida

Versión 9

Esta página también está disponible para…

Comentarios

Descompactar Arquivo

n_abrir_zip is int = zipOpen("nomezip1","e:\aleva\zip\zz.zip")
IF n_abrir_zip = 0 THEN
n_extrai_arquivo is int = zipExtractFile("nomezip1",1,"E:\aleva\zip\")
END

//Blog com video
// http://windevdesenvolvimento.blogspot.com.br/2016/01/windev21-curso-210-descompactar-arquivo.html

De matos AMARILDO

05 01 2016

Última modificación: 19/06/2020

Señalar un error o enviar una sugerencia | Ayuda local