ao_string_tokenize
NAMESYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
EXAMPLES
SEE ALSO
NAME
ao_string_tokenize - tokenize an input string
SYNOPSIS
#include
<your-opts.h>
cc [...] -o outfile infile.c -lopts [...]
token_list_t* ao_string_tokenize(char const* string);
DESCRIPTION
This function will convert one input string into a list of strings. The list of strings is derived by separating the input based on white space separation. However, if the input contains either single or double quote characters, then the text after that character up to a matching quote will become the string in the list.
The returned pointer should be deallocated with free(3C) when are done using the data. The data are placed in a single block of allocated memory. Do not deallocate individual token/strings.
The structure pointed to will contain at least these two fields:
tkn_ct The number of tokens found in the input string.
tok_list An array of tkn_ct + 1 pointers to substring tokens, with the last pointer set to NULL.
There are two
types of quoted strings: single quoted (’) and
double quoted ("). Singly quoted strings are
fairly raw in that escape characters (\) are simply
another character, except when preceding the following
characters:
\ double backslashes reduce to one
’ incorporates the single quote into the string
0fP suppresses both the backslash and newline
character
Double quote strings are formed according to the rules of string constants in ANSI-C programs.
|
string |
string to be tokenized |
RETURN VALUE
pointer to a structure that lists each token
ERRORS
NULL is returned and errno will be set to indicate the problem:
EINVAL − There was an unterminated quoted string.
ENOENT − The input string was empty.
ENOMEM − There is not enough memory. @end itemize
EXAMPLES
#include
<stdlib.h>
int ix;
token_list_t* ptl = ao_string_tokenize(some_string)
for (ix = 0; ix < ptl->tkn_ct; ix++)
do_something_with_tkn(ptl->tkn_list[ix]);
free(ptl);
Note that everything is freed with the one call to
free(3C).
SEE ALSO
The info
documentation for the -lopts library.
configFileLoad(3), optionFileLoad(3),
optionFindNextValue(3), optionFindValue(3), optionFree(3),
optionGetValue(3), optionLoadLine(3), optionMemberList(3),
optionNextValue(3), optionOnlyUsage(3), optionProcess(3),
optionRestore(3), optionSaveFile(3), optionSaveState(3),
optionUnloadNested(3), optionVersion(3), strequate(3),
streqvcmp(3), streqvmap(3), strneqvcmp(3),
strtransform(3),
More Linux Commands
manpages/lessecho.1.html
lessecho(1) - expand metacharacters - Linux manual page.....
lessecho is a program that simply echos its arguments on standard output. But any metacharacter in the output is preceded by an escape character, which by defau
manpages/XML::DOM::Notation.3pm.html
XML::DOM::Notation(3pm) - An XML NOTATION in XML::DOM.......
XML::DOM::Notation extends XML::DOM::Node. This node represents a Notation, e.g. <!NOTATION gs SYSTEM GhostScript> <!NOTATION name PUBLIC pubId> <!NOTATION name
manpages/glutMenuStatusFunc.3.html
glutMenuStatusFunc(3) - sets the global menu status callback
glutMenuStatusFunc sets the global menu status callback so a GLUT program can determine when a menu is in use or not. When a menu status callback is registered,
manpages/gnutls_pem_base64_decode_alloc.3.html
gnutls_pem_base64_decode_alloc(3) - API function (Man Page)
This function will decode the given encoded data. The decoded data will be allocated, and stored into result. If the header given is non null this function will
manpages/VisualOfCCC.3.html
VisualOfCCC(3) - Color Conversion Context macros (Man Page)
The DisplayOfCCC macro returns the display associated with the specified CCC. The VisualOfCCC macro returns the visual associated with the specified CCC. The Sc
manpages/setserial.8.html
setserial(8) - get/set Linux serial port information........
setserial is a program designed to set and/or report the configuration information associated with a serial port. This information includes what I/O port and IR
manpages/ExtUtils::MM_AIX.3pm.html
ExtUtils::MM_AIX(3pm) - AIX specific subclass of ExtUtils::M
This is a subclass of ExtUtils::MM_Unix which contains functionality for AIX . Unless otherwise stated it works just like ExtUtils::MM_Unix Overridden methods d
manpages/rt_sigpending.2.html
rt_sigpending(2) - examine pending signals - Linux man page
sigpending() returns the set of signals that are pending for delivery to the calling thread (i.e., the signals which have been raised while blocked). The mask o
manpages/set_term.3ncurses.html
set_term(3ncurses) - curses screen initialization and manipu
initscr is normally the first curses routine to call when initializing a program. A few special routines sometimes need to be called before it; these are slk_in
manpages/pppstats.8.html
pppstats(8) - print PPP statistics - Linux manual page......
The pppstats utility reports PPP-related statistics at regular intervals for the specified PPP interface. If the interface is unspecified, it will default to pp
manpages/Tcl_Tell.3.html
Tcl_Tell(3) - buffered I/O facilities using channels........
The Tcl channel mechanism provides a device-independent and platform-independent mechanism for performing buffered input and output operations on a variety of f
manpages/gpm-root.1.html
gpm-root(1) - a default handler for gpm, used to draw menus
The program gpm-root is designed to handle Control-Mouse events to draw menus on the background of the current tty. The actual menus are described by a configur
