DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives
  • Niveau de compression
  • Codes d'erreur
  • Condition d'utilisation
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
Crée une archive. L'archive créée est automatiquement :
  • ouverte en lecture et écriture. Si l'archive est au format CAB, l'archive créée est ouverte en écriture seulement.
  • de type mono-partie.
L'archive créée peut être :
  • au format standard WinZip ou PKZip (extension .ZIP).
  • au format "Cabinet files" (extension .CAB).
  • au format WINDEV (extension .WDZ).
  • au format 7z (extension .7z).
  • au format TAR (extension .TAR).
  • au format TGZ (TAR.GZ) (extension .TGZ ou .TAR.GZ).
  • Nouveauté SaaS
    au format gzip (extension .gz).
Il n'est pas possible de créer une archive au format "RAR".
MonArchive est une zipArchive
ResCréation est un entier
ResAjoutFichier est un entier
// Création de l'archive 
ResCréation = zipCrée(MonArchive, "C:\Temp\Archive.zip")
SI ResCréation = 0 ALORS
	// Ajout d'un fichier dans une archive
	ResAjoutFichier = zipAjouteFichier(MonArchive, ...
			"C:\MonRépertoire\MesFichiers\Fichier.pdf", zipDisque)
FIN
// Affichage du message d'erreur si le fichier n'a pas été ajouté
SI ResAjoutFichier <> 0 ALORS 
	Erreur(zipMsgErreur(ResAjoutFichier))
FIN
Syntaxe
<Résultat> = zipCrée(<Archive> , <Chemin de l'archive> [, <Options>])
<Résultat> : Entier
  • 0 si la création a été effectuée. Dans ce cas, l'archive est ouverte. Pour que cette archive soit manipulable par l'utilisateur avant la fermeture de l'application, pensez à fermer l'archive (fonction zipFerme).
  • 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 :
<Chemin de l'archive> : Chaîne de caractères
Chemin et nom de l'archive (260 caractères maximum). L'extension de l'archive doit être précisée :
  • ".WDZ" pour créer une archive WINDEV.
  • ".ZIP" pour créer une archive au format standard WinZip ou PKZip.
  • ".CAB" pour créer une archive au format "Cabinet Files".
  • ".7z" pour créer une archive au format 7Z.
  • ".TAR" pour créer une archive au format TAR.
  • ".TAR.GZ" pour créer une archive au format TAR.GZ.
  • ".TGZ" pour créer une archive au format TGZ.
  • Nouveauté SaaS
    ".gz" pour créer une archive au format gzip.
Si aucune extension n'est précisée, une archive au format WDZ est créée.
Attention :
  • LinuxUniversal Windows 10 App Seules les archives au format ZIP, gzip, TAR et TGZ (TAR.GZ) sont disponibles.
  • Java Seules les archives au format ZIP sont disponibles.
  • Java Si l'extension .WDZ est donnée, l'archive créée sera au format ZIP, mais avec l'extension .WDZ.
  • Si la même archive existe déjà dans le répertoire spécifié, cette archive est détruite et remplacée par la nouvelle archive.
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).
<Options> : Constante optionnelle
Options de gestion des archives :
zipAnsiPermet de forcer la sauvegarde des noms de fichiers au format Ansi dans le fichier Archive.
Cette constante est utilisée par défaut dans une application utilisant le mode Ansi.
Java Cette constante n'est pas disponible.
zipEntête64Permet de :
  • créer une archive de plus de 4 gigas sur laquelle la fonction zipChangeChemin pourra être utilisée.
  • augmenter le nombre de fichiers présents dans une archive au format ZIP. Par défaut, cette limite est de 65535 fichiers. En utilisant cette constante, la limite passe à 4 294 967 295 fichiers.
Par défaut, cette option n'est pas utilisée.
Archive au format TAR, gzip ou TGZ (TAR.GZ) : Cette constante n'est pas disponible.
Java Cette constante n'est pas disponible.
zipNonCompresséLe contenu de l'archive ne sera pas compressé.
Utilisée avec les archives de type CAB, cette constante permet d'utiliser uniquement la fonction d'archivage du format CAB.
Par défaut, cette option n'est pas utilisée.
Archive au format TAR, gzip ou TGZ (TAR.GZ) : Cette constante n'est pas disponible.
zipUnicodePermet de forcer la sauvegarde des noms de fichiers au format Unicode dans le fichier Archive.
Cette constante est utilisée par défaut dans une application utilisant le mode Unicode.
Archive au format TAR, gzip ou TGZ (TAR.GZ) : Si cette constante est utilisée, les noms de fichiers au format Unicode ne sont pas sauvegardés en Unicode dans le fichier Archive.
Java Cette constante n'est pas disponible.

Archive au format 7z : Ce paramètre n'est pas disponible.
Universal Windows 10 App Ce paramètre n'est pas disponible.
Remarques

Niveau de compression

Par défaut, les fichiers ajoutés dans une archive au format Zip sont compressés. Il est possible de modifier le niveau de compression des fichiers ajoutés dans une archive grâce à la fonction zipNiveauCompression.

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.
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.

Condition d'utilisation

Le nombre maximum de fichiers pouvant être intégrés :
  • dans un fichier WDZ : 232-1.
  • dans un fichier ZIP : 65535.
    Il est possible d'augmenter cette limite à 4 294 967 295 fichiers en utilisant la constante zipEntête64.
  • dans un fichier CAB : 65535.
Formats disponibles :
  • LinuxUniversal Windows 10 App Seules les archives au format ZIP, TAR, gzip et TGZ (TAR.GZ) sont disponibles.
  • Java Seules les archives au format ZIP sont disponibles.
Un fichier intégré dans une archive (quel que soit son format) doit avoir une taille inférieure à 4 Go.
Il n'est pas possible de créer une archive au format "RAR".
Classification Métier / UI : Code métier
Composante : wd300zip.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/09/2024

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