NAME
parse_on_string - Copies characters up to a search string.
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 parse_on_string
(
char **input_line_ptr,
char *output_string,
size_t max_len,
const char *search_str
);
DESCRIPTION
This routine consumes characters of an input string up to a search string, or
all characters if the search string is not a substring. Consumed characters
are copied to the buffer output_string, stopping if the buffer size "max_len"
is reached. Regardless, the copied string is always NULL terminated.
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.
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
,
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
,
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