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