PROLOG<\/a> This manual page is part of the POSIX Programmer\u2019s Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.<\/p>\n getsubopt \u2014 parse suboption arguments from a string<\/p>\n #include int getsubopt(char **optionp<\/i>, char bodies manpages.csv script_extrae_body.sh script.sh usr const *keylistp<\/i>, char **valuep<\/i>);<\/p>\n The getsubopt<\/i>() function shall parse suboption arguments in a flag argument. Such options often result from the use of getopt<\/i>().<\/p>\n The getsubopt<\/i>() argument optionp<\/i> is a pointer to a pointer to the option argument string. The suboption arguments shall be separated by The keylistp<\/i> argument shall be a pointer to a vector of strings. The end of the vector is identified by a null pointer. Each entry in the vector is one of the possible tokens that might be found in *optionp<\/i>. Since The valuep<\/i> argument is the address of a value string pointer.<\/p>\n If a If the string at *optionp<\/i> contains only one suboption argument (equivalently, no Additionally, when getsubopt<\/i>() fails to match the suboption argument with a token in the keylistp<\/i> array, the calling application should decide if this is an error, or if the unrecognized option should be processed in another way.<\/p>\n The getsubopt<\/i>() function shall return the index of the matched token string, or \u22121 if no token strings were matched.<\/p>\n No errors are defined.<\/p>\n The following sections are informative.<\/i><\/p>\n Parsing Suboptions<\/b><\/i> #include int do_all; enum const char *mount_opts[] = int while ((opt = getopt(argc, argv, “at:o:”)) != -1) \/* Do the real work. *\/<\/p>\n return 0; If the above example is invoked with:<\/p>\n program -o ro,rsize=512<\/p>\n then after option parsing, the variable do_all<\/i> will be 0, type<\/i> will be a null pointer, read_size<\/i> will be 512, write_size<\/i> will be 0, and read_only<\/i> will be 1. If it is invoked with:<\/p>\n program -o oops<\/p>\n it will print:<\/p>\n “Unknown suboption \u2018oops'”<\/p>\n before aborting.<\/p>\n The value of *valuep<\/i> when getsubopt<\/i>() returns \u22121 is unspecified. Historical implementations provide various incompatible extensions to allow an application to access the suboption text that was not found in the keylistp<\/i> array.<\/p>\n The keylistp<\/i> argument of getsubopt<\/i>() is typed as char bodies manpages.csv script_extrae_body.sh script.sh usr const *<\/b> to match historical practice. However, the standard is clear that implementations will not modify either the array or the strings contained in the array, as if the argument had been typed const char bodies manpages.csv script_extrae_body.sh script.sh usr const *<\/b>.<\/p>\n None.<\/p>\n getopt<\/i>()<\/p>\n
NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
RETURN VALUE<\/a>
ERRORS<\/a>
EXAMPLES<\/a>
APPLICATION USAGE<\/a>
RATIONALE<\/a>
FUTURE DIRECTIONS<\/a>
SEE ALSO<\/a>
COPYRIGHT<\/a> <\/p>\n
\nPROLOG <\/a> <\/h2>\n
NAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
RETURN VALUE <\/a> <\/h2>\n
ERRORS <\/a> <\/h2>\n
EXAMPLES <\/a> <\/h2>\n
The following example uses the getsubopt<\/i>() function to parse a value<\/i> argument in the optarg<\/i> external variable returned by a call to getopt<\/i>().<\/p>\n
#include
#include
const char *type;
int read_size;
int write_size;
int read_only;<\/p>\n
{
RO_OPTION = 0,
RW_OPTION,
READ_SIZE_OPTION,
WRITE_SIZE_OPTION
};<\/p>\n
{
[RO_OPTION] = “ro”,
[RW_OPTION] = “rw”,
[READ_SIZE_OPTION] = “rsize”,
[WRITE_SIZE_OPTION] = “wsize”,
NULL
};<\/p>\n
main(int argc, char *argv[])
{
char *subopts, *value;
int opt;<\/p>\n
switch(opt)
{
case ‘a’:
do_all = 1;
break;
case ‘t’:
type = optarg;
break;
case ‘o’:
subopts = optarg;
while (*subopts != ‘ ‘)
{
char *saved = subopts;
switch(getsubopt(&subopts, (char **)mount_opts,
&value))
{
case RO_OPTION:
read_only = 1;
break;
case RW_OPTION:
read_only = 0;
break;
case READ_SIZE_OPTION:
if (value == NULL)
abort();
read_size = atoi(value);
break;
case WRITE_SIZE_OPTION:
if (value == NULL)
abort();
write_size = atoi(value);
break;
default:
\/bin \/boot \/dead.letter \/dev \/etc \/home \/initrd \/lib \/lib64 \/lost+found \/media \/mnt \/opt \/proc \/release-notes.html \/release-notes.txt \/root \/run \/sbin \/srv \/sys \/tmp \/usr \/var Unknown suboption. bodies\/ usr\/
printf(“Unknown suboption \u2018%s’n”, saved);
abort();
}
}
break;
default:
abort();
}<\/p>\n
}<\/p>\nAPPLICATION USAGE <\/a> <\/h2>\n
RATIONALE <\/a> <\/h2>\n
FUTURE DIRECTIONS <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n