1  /*
       2   * argv_parse.h --- header file for the argv parser.
       3   *
       4   * This file defines the interface for the functions argv_parse() and
       5   * argv_free().
       6   *
       7   ***********************************************************************
       8   * int argv_parse(char *in_buf, int *ret_argc, char ***ret_argv)
       9   *
      10   * This function takes as its first argument a string which it will
      11   * parse into an argv argument vector, with each white-space separated
      12   * word placed into its own slot in the argv.  This function handles
      13   * double quotes and backslashes so that the parsed words can contain
      14   * special characters.   The count of the number words found in the
      15   * parsed string, as well as the argument vector, are returned into
      16   * ret_argc and ret_argv, respectively.
      17   ***********************************************************************
      18   * extern void argv_free(char **argv);
      19   *
      20   * This function frees the argument vector created by argv_parse().
      21   ***********************************************************************
      22   *
      23   * Copyright 1999 by Theodore Ts'o.
      24   *
      25   * Permission to use, copy, modify, and distribute this software for
      26   * any purpose with or without fee is hereby granted, provided that
      27   * the above copyright notice and this permission notice appear in all
      28   * copies.  THE SOFTWARE IS PROVIDED "AS IS" AND THEODORE TS'O (THE
      29   * AUTHOR) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
      30   * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
      31   * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
      32   * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
      33   * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
      34   * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
      35   * IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.  (Isn't
      36   * it sick that the U.S. culture of lawsuit-happy lawyers requires
      37   * this kind of disclaimer?)
      38   *
      39   * Version 1.1, modified 2/27/1999
      40   */
      41  
      42  extern int argv_parse(const char *in_buf, int *ret_argc, char ***ret_argv);
      43  extern void argv_free(char **argv);