ao_string_tokenize - tokenize an input string


#include <your-opts.h>
cc [...] -o outfile infile.c -lopts [...]

token_list_t* ao_string_tokenize(char const* string);


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 to be tokenized


pointer to a structure that lists each token


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


#include <stdlib.h>
int ix;
token_list_t* ptl = ao_string_tokenize(some_string)
for (ix = 0; ix < ptl->tkn_ct; ix++)
Note that everything is freed with the one call to free(3C).


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

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

XML::DOM::Notation(3pm) - An XML NOTATION in XML::DOM.......
XML::DOM::Notation extends XML::DOM::Node. This node represents a Notation, e.g. &lt;!NOTATION gs SYSTEM GhostScript&gt; &lt;!NOTATION name PUBLIC pubId&gt; &lt;!NOTATION name

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,

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

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

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

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

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

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

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

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

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

We can't live, work or learn in freedom unless the software we use is free.