Présentation	Documentation				L'équipe	Sérialisation
	Programmes	Objets	Libs Utilitaires	Libs Internes
	Editeur	Syntaxes	Windows	Versions

SCR/AL1 - TOME III. Les librairies utilitaires

5. Le groupe s_strs

5.129 AR_list (file s_stpakl.c:39)

Syntax

ARLIST **AR_list(arname)
char    *arname;

Description

Retourne la liste des fichiers contenus dans un fichier d'archives construit à l'aide de la fonction AR_add().

Le résultat est un tableau de structures ARLIST contenant pour chaque entrée la définition d'un fichier archivé :

    typedef struct _arlist_ {
        long    ar_rsize,       Taille réelle
                ar_psize,       Taille packée
                ar_date;        Date de sauvetage YYYYMMDD
        char    ar_name[51];    Nom du fichier
    } ARLIST;

Le tableau se termine par un pointeur NULL pour undiquer qu'il est terminé. La fonction SCR_free_tbl() permet de libérer l'espace.

Valeur retournée

NULL en cas d'erreur. La variable AR_ERRNO indique le code d'erreur et la fonction AR_error() fournit un texte. En cas de succès, un tableau de structures ARLIST.

Exemple

    ARLIST **arl;
 
    arl = AR_list("myarch.ar");
    for(i = 0 ; arl[i] ; i++)
        printf("%s\n", arl[i]->ar_name);
 
    SCR_free_tbl(arl);

Voir également

AR_error(), AR_extract(), AR_add(), SCR_free_tbl()

5.129.1 File s_stpakl.c

ARLIST **AR_list(arname)