NAME
BUFF_MQ_GET_TOKEN - (MACRO) Sets up call to match_quote_get_token
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 BUFF_MQ_GET_TOKEN
(
const char **input_pos_ptr,
char output_string[ ]
);
DESCRIPTION
The max_len parameter is set to sizeof(output_string).
Using sizeof to set the buffer size is recomended where applicable, as the
code will not be broken if the buffer size changes. HOWEVER, neither this
method, nor the macro, is applicable if line is NOT a character array. If
line is declared by "char *line", then the size of line is the number of
bytes in a character pointer (usually 4), which is NOT what is normally
intended. You have been WARNED!
| The macro BUFF_MQ_GET_TOKEN_OK expands to:
( BUFF_MQ_GET_TOKEN(...) != NO_MORE_TOKENS )
NOTE
This macro is the same as BUFF_CONST_MQ_GET_TOKEN() except that it
should be used when the argment is declared as (char**). Choosing these
macros based on the typing of the first argument is prefered over
casting.
NOTE
The documentation for BUFF_GET_TOKEN has a short example of which
illustrates the general use of this grouup of parsing routines.
RELATED
get_token, const_get_token, gen_get_token, const_gen_get_token,
match_quote_get_token, const_match_quote_get_token,
gen_match_quote_get_token, const_gen_match_quote_get_token,
match_get_token, const_match_get_token, gen_match_get_token,
const_gen_match_get_token, gen_get_last_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
BUFF_GET_TOKEN
,
BUFF_GET_TOKEN_OK
,
BUFF_CONST_GET_TOKEN
,
BUFF_CONST_MQ_GET_TOKEN
,
BUFF_MATCH_GET_TOKEN
,
BUFF_CONST_MATCH_GET_TOKEN
,
BUFF_GEN_GET_TOKEN
,
BUFF_CONST_GEN_GET_TOKEN
,
BUFF_GEN_MQ_GET_TOKEN
,
BUFF_CONST_GEN_MQ_GET_TOKEN
,
BUFF_GEN_MATCH_GET_TOKEN
,
BUFF_CONST_GEN_MATCH_GET_TOKEN
,
BUFF_GEN_GET_LAST_TOKEN
,
BUFF_GEN_GET_LAST_TOKEN_2
,
BUFF_GEN_SPLIT_AT_LAST_TOKEN
,
BUFF_GEN_SPLIT_AT_LAST_TOKEN_2