text: /* The MIT License
  
     Copyright (C) 2011, 2012 Zilong Tan (eric.zltan@gmail.com)
  
     Permission is hereby granted, free of charge, to any person obtaining
     a copy of this software and associated documentation files (the
     "Software"), to deal in the Software without restriction, including
     without limitation the rights to use, copy, modify, merge, publish,
     distribute, sublicense, and/or sell copies of the Software, and to
     permit persons to whom the Software is furnished to do so, subject to
     the following conditions:
  
     The above copyright notice and this permission notice shall be
     included in all copies or substantial portions of the Software.
  
     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
     EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
     MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
     NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
     BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
     ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
     CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
     SOFTWARE.
  */
  
  #ifndef __ULIB_ARGV_H
  #define __ULIB_ARGV_H
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
      /**
       * argv_free - free an argv
       * @argv - the argument vector to be freed
       *
       * Frees an argv and the strings it points to.
       */
      void argv_free(char **argv);
  
      /**
       * argv_split - split a string at whitespace, returning an argv
       * @str: the string to be split
       * @argcp: returned argument count
       *
       * Returns an array of pointers to strings which are split out from
       * @str.  This is performed by strictly splitting on white-space; no
       * quote processing is performed.  Multiple whitespace characters are
       * considered to be a single argument separator.  The returned array
       * is always NULL-terminated.  Returns NULL on memory allocation
       * failure.
       */
      char **argv_split(const char *str, int *argcp);
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif
  