text: /*===========================================================================*
   *                                                                           *
   *  sfltok.h - String tokenisation                                           *
   *                                                                           *
   *  Copyright (c) 1991-2009 iMatix Corporation                               *
   *                                                                           *
   *  ------------------ GPL Licensed Source Code ------------------           *
   *  iMatix makes this software available under the GNU General               *
   *  Public License (GPL) license for open source projects.  For              *
   *  details of the GPL license please see www.gnu.org or read the            *
   *  file license.gpl provided in this package.                               *
   *                                                                           *
   *  This program is free software; you can redistribute it and/or            *
   *  modify it under the terms of the GNU General Public License as           *
   *  published by the Free Software Foundation; either version 2 of           *
   *  the License, or (at your option) any later version.                      *
   *                                                                           *
   *  This program is distributed in the hope that it will be useful,          *
   *  but WITHOUT ANY WARRANTY; without even the implied warranty of           *
   *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the            *
   *  GNU General Public License for more details.                             *
   *                                                                           *
   *  You should have received a copy of the GNU General Public                *
   *  License along with this program in the file 'license.gpl'; if            *
   *  not, write to the Free Software Foundation, Inc., 59 Temple              *
   *  Place - Suite 330, Boston, MA 02111-1307, USA.                           *
   *                                                                           *
   *  You can also license this software under iMatix's General Terms          *
   *  of Business (GTB) for commercial projects.  If you have not              *
   *  explicitly licensed this software under the iMatix GTB you may           *
   *  only use it under the terms of the GNU General Public License.           *
   *                                                                           *
   *  For more information, send an email to info@imatix.com.                  *
   *  --------------------------------------------------------------           *
   *===========================================================================*/
  /*  ----------------------------------------------------------------<Prolog>-
      Synopsis:   Provides functions to break strings into tokens and handle
                  symbol substitution in strings.
   ------------------------------------------------------------------</Prolog>-*/
  
  #ifndef SFLTOK_INCLUDED                /*  Allow multiple inclusions        */
  #define SFLTOK_INCLUDED
  
  
  /*  Function prototypes                                                      */
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  char **tok_split      (const char *string);
  char **tok_split_ex   (const char *string, char separator);
  char **tok_split_rich (const char *string, const char *delims);
  void   tok_free       (char **token_list);
  char **tok_push       (char **token_list, const char *string);
  int    tok_size       (char **token_list);
  size_t tok_text_size  (char **token_list);
  char  *tok_subst      (const char *string, SYMTAB *symbols);
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif
  