• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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(char *in_buf, int *ret_argc, char ***ret_argv);
43 extern void argv_free(char **argv);
44