NAME

parse_on_string - Copies characters up to a search string.

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 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

DOCUMENTER