|
|
|
|
- Codes d'erreur
- Fichier extrait
zipExtraitTout (Fonction) En anglais : zipExtractAll Extrait et décompresse automatiquement la totalité des fichiers d'une archive à un emplacement physique. L'archive manipulée peut être au format CAB, RAR, ZIP, WDZ, 7z, TAR ou TGZ (TAR.GZ).
Syntaxe
<Résultat> = zipExtraitTout(<Archive> [, <Destination des fichiers> [, <Options>] [, <Procédure WLangage>] , [ <Gestion de la jauge>]])
<Résultat> : Entier - 0 si les fichiers ont été extraits,
- Un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.
<Archive> : Chaîne de caractères ou variable de type zipArchive Nom de l'archive à manipuler. Ce nom peut correspondre :- soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
- soit au nom d'une variable de type zipArchive.
Les variables de type zipArchive ne sont pas disponibles en JAVA.
<Destination des fichiers> : Chaîne de caractères ou constante optionnelle Chemin de destination des fichiers extraits :- Chaîne de caractères optionnelle : Les fichiers sont extraits dans le chemin spécifié auquel s'ajoute l'arborescence mémorisée de chaque fichier (le disque n'est pas conservé). Le chemin spécifié est créé s'il n'existe pas.
Le chemin destination du fichier extrait doit correspondre au répertoire de travail de l'application (connu avec la fonction fRepDonnées) ou à un de ses sous-répertoires. - Constante optionnelle :
| | zipDisque | Extraction :- à l'emplacement d'origine du fichier s'il a été mémorisé et si le disque existe.
- avec restauration de l'arborescence du fichier sur le disque en cours si le disque ou si le répertoire mémorisé n'existe pas.
- dans le répertoire en cours si seuls le nom et l'extension du fichier ont été mémorisés.
Remarque : Si la constante zipDisque est utilisée, le format WDZ mémorise le chemin complet du fichier (lettre du lecteur comprise) alors que le format ZIP ne mémorise par la lettre du lecteur.
Cette constante n'est pas disponible. Les répertoires n'ont pas de racine.
Cette constante a le même effet que la constante zipRépertoire.
Archives au format 7z : Cette constante aura le même effet que la constante zipRépertoire. | zipEcrase | Lors de l'extraction, les fichiers existants en lecture seulement sont automatiquement écrasés par les fichiers extraits. Cette constante peut être combinée avec les constantes zipDisque et zipRépertoire. Cette constante n'est pas disponible. | zipRépertoire | Extraction dans le répertoire en cours avec restauration de l'arborescence du fichier (si elle a été mémorisée). |
<Options> : Constante optionnelle Paramétrage de l'extraction (si le paramètre <Destination des fichiers> correspond à une chaîne de caractères) :
| | zipEcrase | Lors de l'extraction, les fichiers existants en lecture seulement sont automatiquement écrasés par les fichiers extraits. |
<Procédure WLangage> : Nom de procédure optionnel Nom de la procédure WLangage qui sera appelée si une erreur est rencontrée lors de l'extraction des fichiers. ATTENTION : Ce paramètre peut être utilisé uniquement si le paramètre <Archive> correspond à une variable de type zipArchive.Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Code erreur>, <Nom du fichier>) où : - <Code erreur> est un entier correspondant au code de l'erreur rencontrée lors de l'extraction du fichier.
- <Nom du fichier> est une chaîne de caractères contenant le chemin du fichier traité par la fonction zipExtraitTout.
La procédure peut renvoyer une des constantes suivantes : | | zipAnnule | Annule l'extraction des fichiers présents dans l'archive. | zipIgnore | Ignore le fichier en erreur. | zipRecommence | Retente l'extraction du fichier. |
<Progression> : Nom de champ ou nom de procédure Mode de gestion de la jauge. Ce paramètre peut correspondre : Si vous manipulez une archive : - au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'extraction de chaque fichier.
- au format CAB et RAR, la jauge est mise à jour uniquement à la fin de l'extraction de chaque fichier.
- au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
Remarques Fichier extrait Les fichiers extraits ne sont pas effacés de l'archive. Pour effacer un ou tous les fichiers de l'archive, utilisez la fonction zipSupprimeFichier ou zipSupprimeTout. Classification Métier / UI : Code métier Composante : wd290zip.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|