| WORDEXP(3) | Library Functions Manual | WORDEXP(3) | 
wordexp —
#include <wordexp.h>
int
  
  wordexp(const
    char * restrict words,
    wordexp_t * restrict
    pwordexp, int
    flags);
void
  
  wordfree(wordexp_t
    *pwordexp);
wordexp() function performs shell-style word
  expansion on words and places the list of expanded words
  into the structure pointed to by pwordexp.
The flags argument is the bitwise inclusive OR of any of the following constants:
WRDE_APPENDwordexp().WRDE_DOOFFSNULL pointers as are specified by the
      we_offs member of we are added
      to the front of we_wordv.WRDE_NOCMDWRDE_REUSEwordexp() but has not been passed to
      wordfree(). The implementation may reuse the space
      allocated to it.WRDE_SHOWERRWRDE_UNDEFThe structure type wordexp_t includes the
    following members:
size_t we_wordc char **we_wordv size_t we_offs
The we_wordc member is the count of generated words.
The we_wordv member points to a list of pointers to expanded words.
The we_offs member is the number of slots to reserve at the beginning of the we_wordv member.
It is the caller's responsibility to allocate the storage pointed
    to by pwordexp. The wordexp()
    function allocates other space as needed, including memory pointed to by the
    we_wordv member.
The wordfree() function frees the memory
    allocated by wordexp().
wordexp() function is implemented as a wrapper
  around the undocumented wordexp shell built-in
  command.
wordexp() function returns zero if successful,
  otherwise it returns one of the following error codes:
WRDE_BADCHAR|’,
      ‘&’,
      ‘;’,
      ‘<’,
      ‘>’,
      ‘(’,
      ‘)’,
      ‘{’,
      ‘}’.WRDE_BADVALWRDE_UNDEF is set in
    flags.WRDE_CMDSUBWRDE_NOCMD is set in
    flags.WRDE_NOSPACEWRDE_SYNTAXWRDE_ERRNOThe wordfree() function returns no
  value.
IFS
wordexp_t we;
wordexp("${EDITOR:-vi} *.c /etc/motd", &we, 0);
execvp(we->we_wordv[0], we->we_wordv);
WRDE_SHOWERR is set in flags.
wordexp() and wordfree()
  functions conform to IEEE Std 1003.1-2001
  (“POSIX.1”). Their first release was in
  IEEE Std 1003.2-1992 (“POSIX.2”). The
  return value WRDE_ERRNO is an extension.
wordexp(), regardless
  of whether the WRDE_NOCMD flag is set. The
  wordexp() function attempts to detect input that would
  cause commands to be executed before passing it to the shell but it does not
  use the same parser so it may be fooled.
| July 13, 2004 | NetBSD 9.3 |