int wordexp(const char *s, wordexp_t *p, int flags);

void wordfree(wordexp_t *p);

Exigences de macros de test de fonctionalités pour la glibc (voir feature_test_macros(7)) :

wordexp(), wordfree() : _XOPEN_SOURCE  

La fonction wordfree() libère la mémoire nouvellement allouée. Plus précisément, elle ne libère pas son argument mais libère le tableau we_wordv ainsi que les chaînes vers lesquelles il pointe.  

Si l'argument s contient un mot qui débute par un caractère de commentaires # hors de tous guillemets, il n'est pas spécifié si ce mot et les suivants sont ignorés ou si le # est considéré comme un caractère normal (Ndt : donc pas comme le caractère qui indique que ce qui le suit doit être considéré comme du commentaire).  

Le résultat de l'expansion de caractères spéciaux ($@, $*, $#, $?, $-, $$, $!, $0) n'est pas spécifié.

Le splittage de champs est effectué en utilisant la variable d'environnement $IFS. Si elle n'est pas positionnée, les séparateurs de champs sont l'espace, la tabulation et le caractère nouvelle ligne.  

WRDE_APPEND

Ajouter les mots trouvés au tableau résultant d'un précédent appel.

WRDE_DOOFFS

Insérer we_offs caractères initiaux NULL dans le tableau we_wordv. (Ils ne seront pas comptés dans le membre we_wordc retourné.)

WRDE_NOCMD

Ne pas effectuer la substitution de commande.

WRDE_REUSE

Le paramètre p résultant d'un précédent appel à wordexp(), et wordfree() n'a pas été appelé. Réutiliser l'espace de stockage alloué.

WRDE_SHOWERR

Normalement, lors d'une substitution de commande stderr est redirigée vers /dev/null. Ce drapeau spécifie que stderr ne sera pas redirigé.

WRDE_UNDEF

Considérer comme une erreur le fait qu'une variable shell non définie soit expansée.

WRDE_BADCHAR

Occurence illégale d'un caractère nouvelle ligne ou d'un caractère parmi |, &, ;, <, >, (, ), {, }.

WRDE_BADVAL

Il y a une référence à une variable shell non définie, et l'attribut WRDE_UNDEF nous demande de considérer que c'est une erreur.

WRDE_CMDSUB

Une substitution de commande est apparue, et l'attribut WRDE_NOCMD nous demande de considérer que c'est une erreur.

WRDE_NOSPACE

Pas assez de mémoire.

WRDE_SYNTAX

Erreur de syntaxe shell, comme des parenthèses ou des guillemets non appareillés.

#include <stdio.h>
#include <stdlib.h>
#include <wordexp.h>

int
main(int argc, char **argv)
{
    wordexp_t p;
    char **w;
    int i;

    wordexp("[a-c]*.c", &p, 0);
    w = p.we_wordv;
    for (i=0; i < p.we_wordc; i++)
        printf("%s\n", w[i]);
    wordfree(&p);
    exit(EXIT_SUCCESS);
}

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 4 juillet 2005 et révisée le 8 janvier 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 wordexp ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

L'argument chaîne

L'expansion

Le tableau de sortie

L'argument flags

VALEUR RENVOYÉE

CONFORMITÉ

EXEMPLE

VOIR AUSSI

TRADUCTION