{"id":4595,"date":"2021-02-06T00:01:07","date_gmt":"2021-02-06T08:01:07","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=4595"},"modified":"2021-02-13T09:26:42","modified_gmt":"2021-02-13T17:26:42","slug":"parsing-and-converting","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=4595","title":{"rendered":"Parsing and Converting"},"content":{"rendered":"

The goal stated in last week’s Lesson<\/a> is to convert a date formatted in a filename string into a time_t<\/em> value. The filename string must be scanned for expected year, month, and date values. This process involves a custom function, convert()<\/em>, as well as the strtol()<\/em> function to translate strings of digits into long int<\/em> values.
\n
\nThe convert()<\/em> function references a string and a length. It pulls the given number of characters from the string, creating a substring for further manipulation:<\/p>\n

char *convert( char *s, int size )<\/code><\/p>\n

Argument *s<\/code> references the string, int<\/em> variable size<\/code> references the substring’s length. Characters are copied one at a time from s<\/code> to a static char<\/em> buffer[]<\/code>. As static<\/em> storage, the buffer’s contents aren’t discarded when the function terminates, which is how the value (its address) is returned.<\/p>\n

Within the convert()<\/em> function, a for<\/em> loop processes each character in the string according to the size<\/code> value. An if<\/em> test checks for a period (separating the filename from the extension) and the null character. If encountered, the program terminates as the filename string is most likely improperly formed. Otherwise, the character is set into the buffer:<\/p>\n

buffer[x] = c<\/code>.<\/p>\n

After the for<\/em> loop ends, the buffer[]<\/code> string is capped with a null character terminator, buffer[x] = '\\0'<\/code>. The address of buffer[]<\/code> is returned and used in the strtol()<\/em> function to generate a long int<\/em> value in the main()<\/em> function. For example:<\/p>\n

month = strtol(convert(filename+4,2),NULL,10);<\/code><\/p>\n

Above, a substring two characters long is extracted from the fifth character of filename<\/code> (filename+x<\/code>) and returned as its own string. The new string is used immediately in the strtol()<\/em> function to obtain an integer value. This value is stored in the month<\/code> variable.<\/p>\n

Here is the full code:<\/p>\n

2021_02_06-Lesson.c<\/a><\/h3>\n
\r\n#include <stdio.h>\r\n#include <stdlib.h>\r\n\r\n\/* copy and convert the digits *\/<\/span>\r\nchar *convert( char *s, int size )\r\n{\r\n    int x;\r\n    static char buffer[5];\r\n    char c;\r\n\r\n    \/* avoid buffer overflow *\/<\/span>\r\n    if( size > 4 )\r\n    {\r\n        fprintf(stderr,\"Buffer overflow: %d\\n\",size);\r\n        exit(1);\r\n    }\r\n\r\n    \/* process the given number of characters *\/<\/span>\r\n    for( x=0; x<size; x++ )\r\n    {\r\n        c = *(s+x);\r\n        if( c=='.' || c=='\\0' )\r\n        {\r\n            fprintf(stderr,\"Malformed filename\\n\");\r\n            exit(2);\r\n        }\r\n        buffer[x] = c;\r\n    }\r\n    buffer[x] = '\\0';\r\n\r\n    return(buffer);\r\n}\r\n\r\nint main(int argc, char *argv[])\r\n{\r\n    char *filename;\r\n    int year, month, day;\r\n    \r\n    \/* check for filename argument *\/<\/span>\r\n    if( argc<2 )\r\n    {\r\n        \/* output error message to standard error *\/<\/span>\r\n        fprintf(stderr,\"Filename option required\\n\\n\");\r\n        \/* leave with exit code 1*\/<\/span>\r\n        exit(1);\r\n    }\r\n    \/* assign to pointer for convenience *\/<\/span>\r\n    filename = argv[1];\r\n\r\n    \/* code to confirm that the file exists goes here *\/<\/span>\r\n    \/* ... *\/<\/span>\r\n    \r\n    \/* extract integers. *\/<\/span>\r\n    year = strtol(convert(filename+0,4),NULL,10);\r\n    month = strtol(convert(filename+4,2),NULL,10);\r\n    day = strtol(convert(filename+6,2),NULL,10);\r\n\r\n    \/* output results *\/<\/span>\r\n    printf(\"%4d %2d %2d\\n\",year,month,day);\r\n\r\n    return(0);\r\n}<\/pre>\n
This code assumes the filename to be in the proper format; no checking is done beyond confirming an argument presents itself (Line 12). Here is the output generated when using the filename 20210115.txt<\/code>:<\/p>\n
2021  1 15<\/code><\/p>\n
And for the filename 2021okay.txt<\/code>:<\/p>\n
2021  0  0<\/code><\/p>\n
The convert()<\/em> function doesn’t validate proper input. Any non-digit text is translated into zero values, as shown in the above output. This condition could be tested for later in the code, though my feeling is that zero is still a valid number.<\/p>\n
In next week’s Lesson<\/a>, I add the time functions required to convert the year<\/code>, month<\/code>, and day<\/code> int values into a time_t<\/em> value.<\/p>\n","protected":false},"excerpt":{"rendered":"
Data from a filename string must be parsed into individual year, month, and day integers. 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-4595","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\/4595","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=4595"}],"version-history":[{"count":5,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/4595\/revisions"}],"predecessor-version":[{"id":4627,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/4595\/revisions\/4627"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=4595"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=4595"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=4595"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}