DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives
  • Conditions d'utilisation
  • Codes d'erreur
  • Destination de l'archive
  • Suppression de l'archive originale
  • Espace réservé
  • Ordre de découpage
  • Nombre de parties
  • Fermeture de l'archive
  • Actions réalisables sur 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
Découpe une archive en plusieurs sous-archives d'une taille donnée.
Exemple
WINDEVCode Utilisateur (MCU)
ResOuvreArchive, ResDécoupe sont des entiers
Archive est un zipArchive
 
// Ouverture de l'archive "Archive"
ResOuvreArchive = Archive.Ouvre("D:\Sauvegardes\Sauvegarde.WDZ")
 
SI ResOuvreArchive = 0 ALORS
// Découpage d'une archive en plusieurs sous-archives (1,4 Mo chacune)
ResDécoupe = Archive.Découpe("A:\Archive.WDZ", 1400*1024)
...
FIN
Syntaxe
<Résultat> = <Archive>.Découpe(<Destination de l'archive> [, <Taille des sous-archives> [, <Suppression de l'archive originale> [, <Espace réservé> [, <Gestion de la jauge>]]]])
<Résultat> : Entier
  • 0 si l'archive a été découpé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> : Variable de type zipArchive
Nom d'une variable de type zipArchive correspondant à l'archive à manipuler.
<Destination de l'archive> : Chaîne de caractères
Chemin complet de la nouvelle archive multi-parties (260 caractères maximum). Ce chemin doit contenir le nom de l'archive multi-parties à créer. Il est possible de spécifier le même chemin et nom que l'archive originale : l'archive originale sera écrasée par l'archive découpée.
<Taille des sous-archives> : Entier optionnel
Taille en octets des volumes à créer. La taille par défaut des sous-archives est égale à 1,4 Mo (1400*1024 octets). La taille minimale est égale à 300 Ko par sous-archive (300*1024 octets).
<Suppression de l'archive originale> : Booléen optionnel
  • Vrai si l'archive originale doit être détruite pendant le découpage,
  • Faux (valeur par défaut) si l'archive originale ne doit pas être détruite pendant le découpage.
<Espace réservé> : Entier optionnel
Taille (en octets) d'un espace réservé à diminuer de la première sous-archive. La taille de la première sous-archive correspondra à : <Taille des sous-archives> - <Espace réservé>.
<Gestion de la jauge> : Chaîne de caractères optionnelle
WINDEV Nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression du découpage.
Remarques

Conditions d'utilisation

Le découpage d'une archive ne peut être réalisé que si :
  • L'archive existe (la création d'une archive s'effectue avec la fonction <Variable zipArchive>.Crée).
  • L'archive est accessible en lecture et en écriture.
  • L'archive est mono-partie.
Attention :
  • Archives au format "CAB" : Cette fonction n'est pas disponible.
  • Archives au format "RAR" : Cette fonction n'est pas disponible.
  • Archives au format "7z" : Cette fonction n'est pas disponible.
  • Archives au format "TAR" et "TARGZ" : Cette fonction n'est pas disponible.
Linux Rappel : Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) sont disponibles.

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 sous-archives ne sont pas dans l'ordre.
  • 22 : Il est interdit de découper une archive au format zip en une seule partie.
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.

Destination de l'archive

<Destination> doit correspondre à un support accessible en lecture et en écriture. Ce support peut être :
  • Un disque dur.
  • Un lecteur réseau auquel une lettre de lecteur a été attribué. Il est impossible d'effectuer un découpage vers un lecteur UNC.
Extension de l'archive multi-parties (format WDZ)Extension de l'archive multi-parties (format ZIP)
Si l'extension de l'archive n'est pas précisée, l'extension par défaut de la première sous-archive sera .WDZ.
L'extension des autres sous-archives seront automatiquement rajoutées (".001" à ".999").
Par exemple : si <Destination> = "C:\MesArchives\ArchiveDécoupée.WDZ", l'archive sera découpée dans le répertoire "C:\MesArchives" de la manière suivante :
  • ArchiveDécoupée.WDZ
  • ArchiveDécoupée.001
  • ArchiveDécoupée.002
  • ArchiveDécoupée.003
  • ...
Si l'extension de l'archive n'est pas précisée, l'extension par défaut de la première sous-archive sera .ZIP.
L'extension des autres sous-archives seront automatiquement rajoutées (".Z01" à ".Z99").
Par exemple : si <Destination> = "C:\MesArchives\ArchiveDécoupée.ZIP", l'archive sera découpée dans le répertoire "C:\MesArchives" de la manière suivante :
  • ArchiveDécoupée.ZIP
  • ArchiveDécoupée.Z01
  • ArchiveDécoupée.Z02
  • ArchiveDécoupée.Z03
  • ...

Suppression de l'archive originale

Lorsque le paramètre <Suppression de l'archive originale> a pour valeur Vrai, le découpage entraîne la fermeture de l'archive originale ainsi que sa destruction au fur et à mesure du découpage.
Remarques :
  • Pour minimiser l'espace disque nécessaire pour effectuer le découpage, configurez le paramètre <Suppression de l'archive originale> à Vrai. En effet, pour découper une archive de taille importante, l'espace disque nécessaire correspond à deux fois la taille de l'archive : une fois pour l'archive originale et une fois pour l'archive découpée.
  • Ce paramètre doit être utilisé avec prudence. En effet, en cas de problème pendant le découpage, l'archive originale et l'archive découpée seront toutes les deux détruites. Si l'espace disque est suffisant, il est préférable de découper l'archive originale et de supprimer cette même archive originale par la suite.

Espace réservé

La taille de la première sous-archive peut être plus petite que la taille des autres sous-archives. Il suffit d'indiquer la taille en octets à diminuer de la première sous-archive dans le paramètre <Espace réservé>.
La taille de la première sous-archive correspondra à : <Taille des sous-archives> - <Espace réservé>.
Remarque : La taille de la première sous-archive doit respecter la formule suivante :
<Taille des sous-archives> - <Espace réservé> > 300 Ko

Ordre de découpage

Lors du découpage d'une archive, l'ordre de découpage est le suivant :
  • Création de la sous-archive N (extension ".NNN-1" ou ".ZNN-1").
  • ...
  • Création de la sous-archive 2 (extension ".001" ou "Z01").
  • Création de la sous-archive 1 (extension ".WDZ" ou "ZIP").
Par exemple, si une archive est découpée en 4 parties, 4 sous-archives seront construites. La quatrième sous-archive (extension ".003" ou "Z03") sera créée en premier. La première sous-archive (extension ".WDZ" ou ".ZIP") sera créée en dernier.

Nombre de parties

La fonction <Variable zipArchive>.NbPartieNécessaire permet de connaître le nombre de parties nécessaires au découpage de l'archive.
La fonction zipNbPartie permet de connaître le nombre de sous-archives d'une archive multi-parties.
Remarque : Le découpage d'une archive au format ZIP en une seule partie est interdit et provoque une erreur.

Fermeture de l'archive

Après utilisation de la fonction <Variable zipArchive>.Découpe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser les fonctions :
Remarque : Si le paramètre <Suppression de l'archive originale> a pour valeur Vrai, l'archive originale est automatiquement fermée par le découpage.

Actions réalisables sur une archive multi-parties

Certaines fonctions d'archivage sont utilisables uniquement sur des archives mono-partie (ajout et suppression de fichiers, création d'un exécutable auto-extractible, ...). Pour effectuer ces opérations, il suffit de regrouper les sous-archives (fonction <Variable zipArchive>.Regroupe) pour obtenir une archive mono-partie.
A partir d'une archive multi-parties, il est uniquement possible de :
Composante : wd290zip.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