Provided by: libstropt-dev_0.1.2-1_amd64 
NAME
stropt, stroptx, stropt2buf, stropt2str - Parse options from a string (it supports quotation, option
arguments)
SYNOPSIS
#include <stropt.h>
int stropt(const char *input, char **tags, char **args, char *buf);
int stroptx(const char *input, char *features, char *sep, int flags, char **tags, char **args, char
*buf);
char *stropt2buf(void *buf, size_t size, char **tags, char **args, char sep, char eq);
char *stropt2str(char **tags, char **args, char sep, char eq);
DESCRIPTION
This small library parses a list of options from a string. Options can be separated by spaces, commas,
semicolons, tabs or new line. (e.g. uppercase,bold,underlined ). Options may have arguments (e.g.
ro,noatime,uid=0,gid=0 ). It is possible to protect symbols and spaces using quote, double quote and
backslash (e.g. values='1,2,3,4',equal== )
stropt This function parses a list of options from the string input. Options can be separated by commas,
semicolons, tabs oe new lines. Options may have arguments in the form keyword=value. buf is a
temporary buffer, it must have the same size of the input string (including the NULL terminator).
tags and args are the resulting arrays of options and arguments respectively. Both tags and args
have one NULL terminator element at the end. When an option has not an argument the corresponding
args element is NULL. For example if input is "font=12,typeface=bodoni,italic", tags[0]="font",
tags[1]="typeface", tags[2]="italic", tags[4]=NULL, args[0]="12", args[1]="bodoni", args[0]=NULL,
args[4]=NULL.
When stropt is called with tags, args, and buf all NULL, it parses the input, counting the
options. The return value can be used to allocate suitable arrays for tags and args.
It is possible to use the same variable as input and buffer. In this case the original value of
input is overwritten.
stroptx
This is a more configurable extension of stropt. Arguments having the same names as in stropt have
the same meaning as explained above.
The string features permits one to enable/disable some of the standard features. Each feature
corresponds to a mnemonic character, when the character is in the features string the feature is
enabled:
': single quoting,
": double quoting,
\: character escape,
\n:input in several lines,
=: allow arguments,
#: support comments.
If features is NULL all the features are enabled, when features is an empty string all features
are disabled.
All the characters included in sep are considered as option separators. If sep is NULL, the
default value is " \t;,".
The flag argument may include the bitwise OR of any of the following flag values:
STROPTX_KEEP_QUOTATION_MARKS_IN_TAGS: preserve the quotation marks in tags,
STROPTX_KEEP_QUOTATION_MARKS_IN_ARGS: preserve the quotation marks in args,
STROPTX_KEEP_QUOTATION_MARKS: shortcut for STROPTX_KEEP_QUOTATION_MARKS_IN_TAGS |
STROPTX_KEEP_QUOTATION_MARKS_IN_ARGS
STROPTX_ALLOW_MULTIPLE_SEP: when it is not set, a sequence of separators is processed as a single
separator, when it is set each sequence of two separators means an empty field in between.
STROPTX_NEWLINE_TAGS: when set each new line is encoded as a tag "\n".
stropt2buf
This function re-encodes an array of options (and an array of arguments) in a string. It is the
inverse function of of stropt. Given a buffer buf of size size, the array of options tags with
their corresponding values in the array args is encoded using the separator character sep and the
assignment character eq.
Elements whose option tag (element of tags) value is STROPTX_DELETED_TAG are omitted in output.
stropt2str
This is the sibling function of stropt2buf. It uses dynamically allocated memory instead of a
buffer provided by the caller. The resulting string must be deallocated using free(3).
RETURN VALUE
• stropt and stroptx return the number of options + 1.
• stropt2buf and stropt2str return the resulting string.
EXAMPLES
The following function lists the option tags and arguments (without modyfying the input string).
void parse_args(char *input) {
int tagc = stropt(input, NULL, NULL, NULL);
if(tagc > 0) {
char buf[strlen(input)+1];
char *tags[tagc];
char *args[tagc];
stropt(input, tags, args, buf);
for (int i=0; i<tagc; i++)
printf("%s = %s\n",tags[i], args[i]);
}
}
it is possible to use the same input string as the buffer for parsing (the value of the input string gets
lost in this way).
void parse_args(char *input) {
int tagc = stropt(input, NULL, NULL, NULL);
if(tagc > 0) {
char *tags[tagc];
char *args[tagc];
stropt(input, tags, args, input);
for (int i=0; i<tagc; i++)
printf("%s = %s\n",tags[i], args[i]);
}
}
when options to parse have no arguments, args can be set to NULL.
void parse_args(char *input) {
int tagc = stropt(input, NULL, NULL, NULL);
if(tagc > 0) {
char buf[strlen(input)+1];
char *tags[tagc];
stropt(input, tags, NULL, buf);
for (int i=0; i<tagc; i++)
printf("%s \n",tags[i]);
}
}
The following complete program parses and re-encode a string of comma separated arguments deleting those
which begin by an uppercase letter.
#include <stdio.h>
#include <ctype.h>
#include <stdlib.h>
#include <string.h>
#include <stropt.h>
char *delete_uppercase_options(const char *input) {
int tagc = stroptx(input, "", ",",STROPTX_ALLOW_MULTIPLE_SEP, NULL, NULL, NULL);
if(tagc > 0) {
char buf[strlen(input)+1];
char *tags[tagc];
int i;
stroptx(input, "", ",",STROPTX_ALLOW_MULTIPLE_SEP, tags, NULL, buf);
for (i = 0; i < tagc; i++)
if (tags[i] && isupper(tags[i][0]))
tags[i] = STROPTX_DELETED_TAG;
return stropt2str(tags, NULL, ',', '=');
} else
return NULL;
}
int main(int argc, char *argv[]) {
if (argc > 1) {
char *result = delete_uppercase_options(argv[1]);
printf("%s\n", result);
free(result);
}
return 0;
}
AUTHOR
VirtualSquare. Project leader: Renzo Davoli.