DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté exclusive de WINDEV, WEBDEV et WINDEV Mobile SaaS (Update 3). Consultez "Comment utiliser les nouveautés SaaS dans vos projets ?".
Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives
  • Dans quels cas utiliser l'ajout optimisé de fichiers dans une archive
  • Comment utiliser les ajouts optimisés ?
  • Codes d'erreur
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Débute une série d'ajouts optimisés de fichiers dans une archive de type CAB, ZIP, WDZ, 7z, TAR, gzip ou TGZ (TAR.GZ).
Nouveauté SaaS
Cette fonction est une nouveauté disponible à partir de WINDEV Suite SaaS 2025 Update 3.
Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Exemple
// Début des ajouts optimisés de fichiers
zipDébutAjoutFichier(MonArchive)
// Ajout des fichiers dans l'archive
POUR TOUT CheminFichier DE tabListeFichier
	zipAjouteFichier(MonArchive, CheminFichier)
FIN
// Fin ajouts optimisés de fichiers 
zipFinAjoutFichier(MonArchive)
Syntaxe
<Résultat> = zipDébutAjoutFichier(<Archive>)
<Résultat> : Entier
  • 0 si la déclaration du début d'ajout de fichiers a été effectuée,
  • 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 dans laquelle on veut débuter l'ajout de fichiers optimisé.
Ce nom peut correspondre :
Remarques

Dans quels cas utiliser l'ajout optimisé de fichiers dans une archive

Pour les archives de type ZIP, WDZ et 7Z, certaines opérations permettant d'obtenir une archive valide sont effectuées lors de chaque ajout. Ces opérations peuvent influer sur le temps de création d'une archive.
Ainsi, une succession d'ajouts de fichiers via la fonction zipAjouteFichier est plus chronophage que l'ajout de ces mêmes fichiers via la fonction zipAjouteListeFichier. En effet, avec la fonction zipAjouteListeFichier, les opérations de vérification ne sont effectuées qu'une seule fois.
Pour obtenir un comportement similaire en utilisant la fonction zipAjouteFichier, il est nécessaire de réaliser les ajouts entre les fonctions zipDébutAjoutFichier et zipFinAjoutFichier.
Remarque : Cette fonction n'est pas utilisable sur les archives de type RAR et n'est utile que pour les archives de type ZIP, WDZ et 7Z.

Comment utiliser les ajouts optimisés ?

Pour réaliser des ajouts optimisés :
  1. Appelez la fonction zipDébutAjoutFichier. L'archive est en attente de l'ajout des fichiers.
  2. Utilisez la fonction zipAjouteFichier pour ajouter les différents fichiers voulus. Toutes les caractéristiques de cette fonction restent valables.
  3. Terminez l'ajout des fichiers avec la fonction zipFinAjoutFichier.
Remarques :
  • Tout appel à une fonction autre que zipAjouteFichier sur l'archive entre un appel aux fonctions zipDébutAjoutFichier et zipFinAjoutFichier provoquera une erreur fatale.
  • Il est obligatoire d'utiliser la fonction zipFinAjoutFichier après la fonction zipDébutAjoutFichier pour obtenir une archive valide.

Codes d'erreur

Les codes d'erreur retournés sont les suivants :
  • 1 : Le chemin passé en paramètre n'existe pas.
  • 3 : L'archive est corrompue.
Classification Métier / UI : Code métier
Composante : wd300zip.dll
Version minimum requise
  • Version 2025 (SaaS)
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/05/2025

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