NAME

match_get_token - Get the next non-white chunk, ignoring white inside match chars.

SYNOPSIS

#include "l/l_parse.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


size_t match_get_token
(
	char **input_line_ptr,
	char *output_string,
	size_t max_len,
	const char *left_char_str,
	const char *right_char_str
);

DESCRIPTION

This routine is similar to get_token except that terminating blanks are NOT sought inside of paris of matching characters given in "left_char_str" and "right_char_str" pairs. For example, if left_char_str is "{(" and right_char_str is '{(', then this routine would parse ->(a { b } ) c<- into ->(a { b } )<- and ->c<-.

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_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_MATCH_GET_TOKEN, BUFF_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.

RELATED

BUFF_MATCH_GET_TOKEN

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

next_token , const_next_token , get_token , const_get_token , match_quote_get_token , const_match_quote_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 , gen_match_get_token , const_gen_match_get_token , alpha_get_token , gen_get_last_token , gen_get_last_token_2 , gen_split_at_last_token , gen_split_at_last_token_2 , parse_on_string , parse_positive_integer_list , parse_options , free_options , ic_parse_key_words , get_boolean_value , is_no_value_word , parse_path , get_base_name , get_base_path