• 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.

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.
• soit au nom d'une variable de type zipArchive.

Liste des chemins mémorisés des fichiers à extraire de l'archive. Les différents chemins sont séparés par des RC (Retours Chariots).
Effectue une recherche à l'identique sur chaque chemin des fichiers dans l'archive.

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.
  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 :
  

  zipAucun	Extraction dans le répertoire en cours sans restauration de l'arborescence des fichiers (si elle a été mémorisée).
  zipDisque	Extraction : à 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. Cette constante n'est pas disponible. Les répertoires n'ont pas de racine. 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).

Il n'est pas possible d'utiliser ces constantes.

Paramétrage de l'extraction (si le paramètre <Destination> 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. Cette constante n'est pas disponible.

Nom de la procédure WLangage qui sera appelée si une erreur est rencontrée lors de l'extraction des fichiers. Cette procédure est de la forme :

PROCEDURE NomDeLaProcé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 zipExtraitListeFichier.

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.

Cette procédure doit être une procédure serveur.

Ce paramètre est interdit.

Mode de gestion de la jauge. Ce paramètre peut correspondre :

• au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'extraction de la totalité des fichiers manipulés.
• au nom d'une procédure WLangage. Cette procédure est de la forme :
  
  <Nom de la procédure> (<Fichier en cours>, <Pourcentage d'avancement global>,
  <Pourcentage d'avancement du fichier>)
  
  où :
  • <Fichier en cours> correspond au nom du fichier en cours de traitement.
  • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'extraction des fichiers de l'archive.
  • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'extraction du fichier en cours de l'archive.

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.

La procédure doit être une procédure serveur.