NAME
match_quote_get_token - Get the next non-white chunk, ignoring white in quotes.
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_quote_get_token
(
char **input_line_ptr,
char *output_string,
size_t max_len
);
DESCRIPTION
This routine is similar to get_token except that terminating blanks are NOT
sought inside of quote marks. The quotes are not stripped from the
retrieved chunk. Thus, whereas the routine get_token would parse
->a "b c"<- into ->a<- and ->"b<- and ->c"<-, this routine would parse it
into ->a<- and ->"b c"<-. The routine strip_quotes can be used to remove the
quotes.
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_quote_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_MQ_GET_TOKEN, BUFF_MQ_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_MQ_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
,
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
,
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