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