PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
New WINDEV, WEBDEV and WINDEV Mobile 26 feature!
  • Codes d'erreur
  • Filtre
  • Fichier extrait
  • Extraction et mot de passe
  • Chemin mémorisé
  • Extraction à partir d'une archive multi-parties sur disquettes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Extrait et décompresse automatiquement les fichiers présents dans un répertoire de l'arborescence des fichiers d'une archive vers un emplacement physique.
Exemple
Archive est un zipArchive
// Ouverture d'une archive
SI zipOuvre(Archive, "C:\Archives\Archive.zip") = 0 ALORS
// Extraction du répertoire "Temp" à la racine de l'arborescence des fichiers de l'archive
zipExtraitRépertoire(Archive, "Temp", zipDisque)
FIN
Syntaxe
<Résultat> = zipExtraitRépertoire(<Archive> , <Répertoire> [, <Destination> [, <Options> [, <Procédure WLangage> [, <Progression>]]]])
<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 la fonction zipCrée.
  • WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAndroidWidget AndroidiPhone/iPadWidget iOSCatalystAjax soit au nom d'une variable de type zipArchive.
<Répertoire> : Chaîne de caractères (avec guillemets)
Répertoire des fichiers de l'archive à extraire. Ce répertoire peut être un chemin absolu ou relatif par rapport à la racine de l'arborescence des fichiers de l'archive.
<Destination> : Chaîne de caractères 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 du fichier (le disque n'est pas conservé). Le chemin spécifié est créé s'il n'existe pas.
    Universal Windows 10 App 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 :
    zipAucunExtraction dans le répertoire en cours sans restauration de l'arborescence des fichiers (si elle a été mémorisée).
    zipDisqueExtraction :
    • à l'emplacement d'origine des fichiers s'il a été mémorisé et si le disque existe.
    • avec restauration de l'arborescence des fichiers 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 des fichiers ont été mémorisés.
    LinuxiPhone/iPadWidget iOSCatalyst Cette constante n'est pas disponible. Les répertoires n'ont pas de racine.
    AndroidWidget Android Cette constante aura 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.
    zipRépertoire
    (Valeur par défaut)
    Extraction dans le répertoire en cours avec restauration de l'arborescence des fichiers (si elle a été mémorisée).
Windows Mobile Il n'est pas possible d'utiliser ces constantes car le Pocket PC ne gère pas la notion de répertoire en cours.
Universal Windows 10 App Il n'est pas possible d'utiliser ces constantes.
<Options> : Constante de type Entier optionnelle
Paramétrage de l'extraction (si le paramètre <Destination> correspond à une chaîne de caractères) :
zipEcraseLors de l'extraction, les fichiers existants en lecture seulement sont automatiquement écrasés par les fichiers extraits.
AndroidWidget Android Cette constante n'est pas disponible.
<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.
Pour plus de détails sur cette procédure, consultez Paramètres de la procédure de gestion des erreurs utilisée par la fonction zipExtraitRépertoire.
WEBDEV - Code Serveur Cette procédure doit être une procédure serveur.
<Progression> : Nom de champ ou nom de procédure
Versions 21 et supérieures
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.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Nouveauté 21
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.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
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.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Remarques

Codes d'erreur

Les codes d'erreur retournés sont les suivants :
  • 1 : Le chemin passé en paramètre n'existe pas.
  • 2 : Accès interdit : l'utilisateur n'a pas les droits nécessaires.
  • 3 : L'archive est corrompue.
  • 4 : Le chemin n'existe pas dans l'archive.
  • 6 : Les fichiers des sous-archives ne sont pas dans l'ordre (cas d'une extraction dans une archive multi-parties).
  • 21 : Le mot de passe spécifié n'est pas correct.
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.
Remarques :
  • LinuxUniversal Windows 10 AppiPhone/iPadWidget iOSCatalyst Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) sont disponibles.
  • Windows Mobile Seules les archives au format ZIP sont disponibles.
  • AndroidWidget Android Le format CAB n'est pas disponible.

Filtre

Si un filtre a été posé sur l'archive par la fonction zipSélectionFichier, seuls les fichiers respectant le filtre seront extraits.

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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppWindows MobileiPhone/iPadWidget iOSCatalystCode Utilisateur (MCU)Ajax

Extraction et mot de passe

Si le fichier n'est pas crypté et si la fonction zipMotDePasse a été utilisée :
  • Archive au format WDZ : Le fichier est tout de même extrait.
  • Archive au format ZIP : Une erreur apparaît.

Chemin mémorisé

Le tableau ci-dessous présente les chemins mémorisés dans l'archive en fonction :
  • du chemin d'accès du fichier,
  • de la portion mémorisée du chemin.
Le répertoire en cours est : "C:\Temp".
Fonction zipAjouteFichierLocalisation du fichierzipAucunzipRépertoirezipDisque
zipAjouteFichier("Archi",
"Fichier.txt")
C:\Temp\Fichier.txtFichier.txtFichier.txtFichier.txt
zipAjouteFichier("Archi",
"Donnée\Fichier.txt")
C:\Temp\Donnée\Fichier.txtFichier.txtDonnée\Fichier.txtDonnée\Fichier.txt
zipAjouteFichier("Archi",
"D:\Donnée\Fichier.txt")
D:\Donnée\Fichier.txtFichier.txtDonnée\Fichier.txtD:\Donnée\Fichier.txt


Remarque : Si la constante zipDisque est utilisée :
  • le format WDZ mémorise le chemin complet du fichier (lettre du lecteur comprise).
  • le format ZIP ne mémorise pas la lettre du lecteur.
  • le format 7z mémorise uniquement les répertoires.
AndroidWidget Android La constante zipDisque est identique à la constante zipRépertoire.
Universal Windows 10 App Le répertoire et le disque ne sont pas mémorisés dans le chemin de l'archive. Seuls le nom du fichier et son extension sont mémorisés.
Windows Mobile Le tableau ci-dessous présente les chemins mémorisés dans l'archive en fonction :
  • du chemin d'accès du fichier,
  • de la portion mémorisée du chemin.
Fonction zipAjouteFichierLocalisation du fichierzipAucunzipRépertoire
zipAjouteFichier("Archi",
"\Fichier.txt")
\Fichier.txtFichier.txtFichier.txt
zipAjouteFichier("Archi",
"\Temp\Fichier.txt")
\Temp\Fichier.txtFichier.txtTemp\Fichier.txt
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax

Extraction à partir d'une archive multi-parties sur disquettes

Si les fichiers à extraire sont présents sur différentes disquettes, la disquette correspondante est automatiquement demandée.
Composante : wd260zip.dll
Minimum version required
  • Version 26
Comments
Click [Add] to post a comment