{"id":4829,"date":"2021-07-03T00:01:04","date_gmt":"2021-07-03T07:01:04","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=4829"},"modified":"2021-07-10T08:08:00","modified_gmt":"2021-07-10T15:08:00","slug":"discovering-command-line-options-part-ii","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=4829","title":{"rendered":"Discovering Command Line Options, Part II"},"content":{"rendered":"

I suppose smart equates to quirky in most programming circumstances. This maxim definitely holds true for the getopt()<\/em> function<\/a>. Before you can appreciate this function and put it to use, you must understand how it works and why it can be quirky.
\n
\nHere is a sample getopt()<\/em> statement:<\/p>\n

r = getopt(argc,argv,\"ABC\");<\/code><\/p>\n

The argc<\/code> and argv<\/code> arguments are stolen directly from the main()<\/em> function. The third argument implies that this program can swallow up to three optional switches: -A<\/code>, -B<\/code>, and -C<\/code>. These must be specified with the leading dash and the letters are case sensitive. Here is the full code:<\/p>\n

2021_07_03-Lesson-a.c<\/a><\/h3>\n
\r\n#include <stdio.h>\r\n#include <unistd.h>\r\n\r\nint main(int argc, char *argv[])\r\n{\r\n    int r;\r\n\r\n    r = getopt(argc,argv,\"ABC\");\r\n    printf(\"The getopt() function returned %d\\n\",r);\r\n\r\n    return(0);\r\n}<\/pre>\n
The getopt()<\/em> function at Line 8 reads the command line arguments. The return value from the function, stored in variable r<\/code>, is output as an integer at Line 9. The purpose of this program is to discover how getopt()<\/em> processes input. Sample runs are in order, first with no arguments:<\/p>\n
$ .\/a.out
\nThe getopt() function returned -1<\/code><\/p>\n
The return value of -1 means that all command line arguments have been parsed. It would be up to the code at this point to determine whether this condition is wanted or valid. Remember, the return value of -1 isn’t really an error, just a value open to interpretation.<\/p>\n
Next, the valid switch -A<\/code> is specified:<\/p>\n
$ .\/a.out -A
\nThe getopt() function returned 65<\/code><\/p>\n
The function returned the ASCII code value for 'A'<\/code>, 65. Note that the switch is specified as -A<\/code>. Here’s what you see when just A<\/code> is specified:<\/p>\n
$ .\/a.out A
\nThe getopt() function returned -1<\/code><\/p>\n
The function returns -1 for an unrecognized argument. Because the A<\/code> isn’t prefixed with a dash, the function assumes it’s something other than a switch; the getopt()<\/em> function ignores command line arguments not prefixed with a dash.<\/p>\n
Here is the function’s reaction when you type a little -a<\/code> as a switch:<\/p>\n
$ .\/a.out -a
\n.\/a.out: illegal option -- a
\nThe getopt() function returned 63<\/code><\/p>\n
The first line of output is generated by the getopt()<\/em> function itself: -a<\/code> is an “illegal” option. But the program continues, the printf()<\/em> generating it output: The code presented is ASCII 63, the '?'<\/code> character.<\/p>\n
The ugly error message is output by default, though you can suppress it. To do so, set the global variable opterr<\/code> to zero. This variable is an extern int<\/em> defined in the unistd.h<\/code> header file. Here’s is the updated code:<\/p>\n
2021_07_03-Lesson-b.c<\/a><\/h3>\n
\r\n#include <stdio.h>\r\n#include <unistd.h>\r\n\r\nint main(int argc, char *argv[])\r\n{\r\n    int r;\r\n\r\n    opterr = 0;\r\n    r = getopt(argc,argv,\"ABC\");\r\n    printf(\"The getopt() function returned %d\\n\",r);\r\n\r\n    return(0);\r\n}<\/pre>\n
Here is the output with the opterr<\/code> variable set to zero (Line 8 above):<\/p>\n
$ .\/a.out -a
\nThe getopt() function returned 63<\/code><\/p>\n
The takeaway here is that return code 63 indicates an invalid option. Your code can do whatever in such a circumstance.<\/p>\n
One last test! The final character in the third argument, C<\/code>:<\/p>\n
$ .\/a.out -C
\nThe getopt() function returned 67<\/code><\/p>\n
ASCII code 67 represents a ‘C’.<\/p>\n
Each option is detected. Bogus options return value 63, the '?'<\/code> character. Next week’s Lesson<\/a> continues exploration of the getopt()<\/em> function, with the method to review multiple options and how to determine what character was specified as an invalid option.<\/p>\n","protected":false},"excerpt":{"rendered":"
Your code need not toil with processing command line switches as the C library has a function that deftly handles the job. Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-4829","post","type-post","status-publish","format-standard","hentry","category-main"],"_links":{"self":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/4829","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=4829"}],"version-history":[{"count":8,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/4829\/revisions"}],"predecessor-version":[{"id":4875,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/4829\/revisions\/4875"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=4829"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=4829"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=4829"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}