NAME

gen_match_get_token - Get next chunk delimited by specified chars.

SYNOPSIS

#include "l/l_parse.h"

Example compile flags (system dependent):
  -DLINUX_386 -DLINUX_386_P4  
   -I/home/kobus/include
   -L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
  -lKJB         -llapack -lblas -lg2c          -lXext -lX11 


int gen_match_get_token
(
	char **input_line_ptr,
	char *output_string,
	size_t max_len,
	const char *terminators,
	const char *left_char_str,
	const char *right_char_str
);

DESCRIPTION

This routine gets the next chunk delimited by specified chars, except when they are inside a pair of the match chars. The match chars are included in the retrieved chunk. This routine combines the behaviour of gen_get_token and match_get_token.

RETURNS

The number of characters copied to the buffer excluding the NULL. This means that if there are no characters left, then NO_MORE_TOKENS is returned which is #defined as 0.

NOTE

This routine is similar to const_gen_match_get_token() except that the argument has been declared as (char**). One should decide between these routines based on this, in preference to casting.

MACROS

BUFF_GEN_MATCH_GET_TOKEN, BUFF_GEN_MATCH_GET_TOKEN_OK

NOTE

The documentation for BUFF_GET_TOKEN has a short example of which illustrates the general use of this grouup of parsing routines.

SEEALSO

BUFF_GEN_MATCH_GET_TOKEN

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTOR

Kobus Barnard

SEE ALSO

next_token , const_next_token , get_token , const_get_token , match_quote_get_token , const_match_quote_get_token , match_get_token , const_match_get_token , gen_get_token , const_gen_get_token , gen_char_get_token , gen_match_quote_get_token , const_gen_match_quote_get_token , const_gen_match_get_token , alpha_get_token , gen_get_last_token , parse_on_string , parse_positive_integer_list , parse_options , free_options , ic_parse_key_words , get_boolean_value , is_no_value_word , get_base_name , get_base_path