PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Codes d'erreur
  • Fichier extrait
  • Extraction sur disquettes à partir d'une archive multi-parties
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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).
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWEBDEV - Code ServeurWindows Cette fonction gère désormais le format 7z.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWEBDEV - Code ServeurWindows Cette fonction gère désormais le format 7z.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWEBDEV - Code ServeurWindows Cette fonction gère désormais le format 7z.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurWindowsLinuxUniversal Windows 10 AppiPhone/iPad Cette fonction gère désormais les formats TAR et TGZ (TAR.GZ).
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurWindowsLinuxUniversal Windows 10 AppiPhone/iPad Cette fonction gère désormais les formats TAR et TGZ (TAR.GZ).
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurWindowsLinuxUniversal Windows 10 AppiPhone/iPad Cette fonction gère désormais les formats TAR et TGZ (TAR.GZ).
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax
Archive est un zipArchive
 
// Ouverture d'une archive
ResOuvreArchive = zipOuvre(Archive, "C:\Archives\Archive.zip")
 
SI ResOuvreArchive = 0 ALORS
...
// Extraction de tous les fichiers de l'archive
ResExtraitTout = zipExtraitTout(Archive, zipDisque)
...
FIN
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 la fonction zipCrée.
  • Versions 15 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystAjax soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystAjax soit au nom d'une variable de type zipArchive.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidiPhone/iPadWidget IOSMac CatalystAjax soit au nom d'une variable de type zipArchive.
    Versions 26 et supérieures
    AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Les variables de type zipArchive sont désormais disponibles.
    Nouveauté 26
    AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Les variables de type zipArchive sont désormais disponibles.
    AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Les variables de type zipArchive sont désormais disponibles.
<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.
    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 :
    zipDisqueExtraction :
    • à 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.

    LinuxiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible. Les répertoires n'ont pas de racine.

    AndroidWidget AndroidJava 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.
    zipRépertoireExtraction dans le répertoire en cours avec restauration de l'arborescence du fichier (si elle a été mémorisée).
    zipEcraseLors 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.
    AndroidWidget AndroidJava Cette constante n'est pas disponible.

Universal Windows 10 App Il n'est pas possible d'utiliser ces constantes.
<Options> : Constante optionnelle
Paramétrage de l'extraction (si le paramètre <Destination des fichiers> 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 AndroidJava Cette constante n'est pas disponible.
<Procédure WLangage> : Nom de procédure optionnel
Versions 19 et supérieures
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 :
zipAnnuleAnnule l'extraction des fichiers présents dans l'archive.
zipIgnoreIgnore le fichier en erreur.
zipRecommenceRetente l'extraction du fichier.

WEBDEV - Code Serveur Cette procédure doit être une procédure serveur.
AndroidWidget AndroidJava Ce paramètre est interdit.
Nouveauté 19
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 :
zipAnnuleAnnule l'extraction des fichiers présents dans l'archive.
zipIgnoreIgnore le fichier en erreur.
zipRecommenceRetente l'extraction du fichier.

WEBDEV - Code Serveur Cette procédure doit être une procédure serveur.
AndroidWidget AndroidJava Ce paramètre est interdit.
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 :
zipAnnuleAnnule l'extraction des fichiers présents dans l'archive.
zipIgnoreIgnore le fichier en erreur.
zipRecommenceRetente l'extraction du fichier.

WEBDEV - Code Serveur Cette procédure doit être une procédure serveur.
AndroidWidget AndroidJava Ce paramètre est interdit.
<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 :
  • WINDEVUniversal Windows 10 AppiPhone/iPadMac Catalyst 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 :
    PROCEDURE <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.
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 :
  • WINDEVUniversal Windows 10 AppiPhone/iPadMac Catalyst 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 :
    PROCEDURE <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.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEVUniversal Windows 10 AppiPhone/iPadMac Catalyst 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 :
    PROCEDURE <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.
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).
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur. Rappel :
  • LinuxUniversal Windows 10 AppiPhone/iPadWidget IOSMac Catalyst Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) sont disponibles.
  • AndroidWidget AndroidJava Seules les archives au format ZIP sont disponibles.

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êtesCode Utilisateur (MCU)Ajax

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

Si les fichiers à extraire sont présents sur différentes disquettes, la disquette correspondante est automatiquement demandée. Pour extraire plusieurs fichiers d'une archive multi-parties, il est conseillé d'extraire les fichiers selon l'ordre de leur indice dans l'archive. Ainsi, les différentes disquettes seront demandées dans l'ordre croissant.
Classification Métier / UI : Code métier
Composante : wd270zip.dll
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment