|
|
|
|
|
- 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
zipDécoupe (Fonction) En anglais : zipSplit Découpe une archive en plusieurs sous-archives d'une taille donnée. Syntaxe
<Résultat> = zipDécoupe(<Archive> , <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> : 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.
![WINDEV WINDEV](https://doc.pcsoft.fr/ext/images/fr/WD.png?-158481145) ![WEBDEV - Code Serveur WEBDEV - Code Serveur](https://doc.pcsoft.fr/ext/images/fr/WBS.png?-1123132264) ![Etats et Requêtes Etats et Requêtes](https://doc.pcsoft.fr/ext/images/fr/ER.png?1036581927) ![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) ![Widget Android Widget Android](https://doc.pcsoft.fr/ext/images/fr/ANDROIDWIDGET.png?2017201516) ![iPhone/iPad iPhone/iPad](https://doc.pcsoft.fr/ext/images/fr/IPHONE.png?1493160723) ![Widget IOS Widget IOS](https://doc.pcsoft.fr/ext/images/fr/WIDGETIOS.png?1313293721) ![Mac Catalyst Mac Catalyst](https://doc.pcsoft.fr/ext/images/fr/CATALYST.png?-1873516274) soit au nom d'une variable de type zipArchive.
<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
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 zipCré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.
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 zipNbPartieNé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 zipDécoupe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser les fonctions : - zipFerme pour fermer l'archive mono-partie.
- zipOuvre pour ouvrir la nouvelle archive multi-parties.
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 zipRegroupe) pour obtenir une archive mono-partie. A partir d'une archive multi-parties, il est uniquement possible de : Classification Métier / UI : Code métier Composante : wd300zip.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|