DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives
  • Codes d'erreur
  • Cas particulier de l'extension .GZ
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
Ouvre une archive existante.
Pour les archives au format "CAB" ou "RAR", si l'archive n'existe pas, elle est créée.
L'archive peut être :
  • au format standard Winzip ou PKZip (extension .ZIP).
  • au format WINDEV (extension .WDZ).
  • au format Cabinet file (extension .CAB).
  • au format RAR (extension .RAR).
  • au format 7z (extension .7z).
  • au format TAR (extension .TAR).
  • au format TGZ (extension .TGZ).
  • au format TAR.GZ (extension .TAR.GZ).
  • Nouveauté SaaS
    au format gzip (extension ;gz).
  • un exécutable (.EXE) correspondant à un fichier .WDZ transformé en archive auto-extractible.
Nouveauté SaaS
WINDEVWEBDEV - Code ServeurWindowsLinuxUniversal Windows 10 AppiPhone/iPad Le format gzip (extension .gz) est désormais géré.
Exemple
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax
MonArchive est une zipArchive
// Ouverture d'une archive
ResOuvreArchive = MonArchive.Ouvre("C:\MesArchives\Archive.zip")

// Affichage du message d'erreur si l'archive n'a pas été ouverte
SI ResOuvreArchive <> 0 ALORS
	Erreur(zipMsgErreur(ResOuvreArchive))
FIN
Syntaxe
<Résultat> = <Archive>.Ouvre(<Chemin de l'archive> [, <Mode d'ouverture>])
<Résultat> : Entier
  • 0 si l'archive a été ouverte,
  • 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> : Variable de type zipArchive
Nom d'une variable de type zipArchive correspondant à l'archive à manipuler.
Si l'archive n'existe pas, elle est créée (sauf pour les formats "CAB" ou "RAR").
<Chemin de l'archive> : Chaîne de caractères
Chemin et nom de l'archive (260 caractères maximum). L'extension de l'archive peut être précisée. Si l'extension de l'archive n'est pas précisée, l'extension par défaut sera .WDZ.
AndroidWidget Android Si l'extension n'est pas précisée, l'extension sera ".ZIP".
Universal Windows 10 App Le chemin de l'archive est un chemin complet ou relatif au répertoire de travail de l'application (connu avec la fonction fRepDonnées).
<Mode d'ouverture> : Constante optionnelle ou combinaison de constantes
Mode d'ouverture de l'archive :
zipCréationSiInexistantCréation de l'archive si l'archive est inexistante
(non disponible pour les fichiers .CAB et les fichiers .RAR)
zipEcritureOuverture en lecture/écriture
(non disponible pour les fichiers .CAB et les fichiers .RAR)
zipEntête64Permet de créer une archive de plus de 4 gigas sur laquelle la fonction <Variable zipArchive>.ChangeChemin pourra être utilisée.
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Cette constante n'est pas disponible.
Archive au format TAR ou TGZ (TAR.GZ) : Cette constante n'est pas disponible.
zipLectureOuverture en lecture seule

Le mode d'ouverture par défaut est : zipCréationSiInexistant + zipEcriture.
Universal Windows 10 App Ce paramètre n'est pas disponible : le mode d'ouverture utilisé correspond à zipCréationSiInexistant + zipEcriture.
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.
  • 6 : Les fichiers des sous-archives ne sont pas dans l'ordre (cas de l'ouverture d'une archive multi-parties).
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur. Rappel :
  • LinuxiPhone/iPadWidget IOSMac Catalyst Seules les archives au format ZIP, gzip, TAR et TGZ (TAR.GZ) sont disponibles.
  • AndroidWidget Android Seules les archives au format ZIP sont disponibles.

Cas particulier de l'extension .GZ

Ne pas confondre les fichiers '.tar.gz' générés par GitHub, et les fichiers '.gz' compressés au format gzip.
Un contenu compressé au format gzip pourra être décompressé avec la fonction Décompresse.
Composante : wd300zip.dll
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale