{"id":5917,"date":"2023-06-24T00:01:23","date_gmt":"2023-06-24T07:01:23","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=5917"},"modified":"2023-06-17T10:49:42","modified_gmt":"2023-06-17T17:49:42","slug":"outputting-a-key-value","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=5917","title":{"rendered":"Outputting a Key Value"},"content":{"rendered":"

The power of an associative array is that it uses keys, text or numbers, to reference values. Know the key and you can fetch the value . This “association” works like an array in C, where you know the index or offset for an element. Though with an associative array, the index is a value or string — the key.
\n
\nFor my demonstration, I continue with an phony associative array of strings used in last week’s Lesson<\/a>. The keys are month names in English with the values their corresponding month names in French. The key()<\/em> function is passed two arguments: *k<\/code> a key to match and *a[]<\/code> the phony-associative array containing the key-value pairs. Here is the function:<\/p>\n

\r\n\/* assumes `char` array *\/<\/span>\r\nchar *key(char *k, char *a[])\r\n{\r\n    int x = 0;\r\n\r\n    \/* the loop ends on the NULL *\/<\/span>\r\n    while( a[x] )\r\n    {\r\n        \/* use strcasecmp() if the library has it *\/<\/span>\r\n        if( strcmp(k,a[x])==0 )\r\n            return(a[x+1]);\r\n        x+=2;\r\n    }\r\n    return(NULL);\r\n}<\/pre>\n
The while<\/em> loop spins until the end of array a[]<\/code>, which is marked with NULL<\/code>s. Within the loop, an strcmp()<\/em> function compares the key passed, *k<\/code>, with each key item in the array, a[x]<\/code>. When a match is found, meaning strcmp()<\/em> returns zero, element a[x+1]<\/code> is returned. The +1<\/code> offset represents the key’s value in the phony-associative array. Otherwise, variable x<\/code> is increased by two to reference the next key in the phony associative array.<\/p>\n
When the array is exhausted, the value NULL<\/code> is returned.<\/p>\n
I could have put the strcmp()<\/em> function within the while()<\/em> loop, but extra overhead is required to determine when the a[x]<\/code> value is NULL<\/code>. It seems less complicated to me to use value a[x]<\/code> as the comparison.<\/p>\n
Also, if your compiler’s library features the strcasecmp()<\/em> function, you can use it instead of strcmp()<\/em>. Though, grammatically speaking, month names in English are capitalized.<\/p>\n
Within the main()<\/em> function, input is requested. The input string is passed to the key()<\/em> function. The value returned is compared with NULL<\/code> and appropriate text is output:<\/p>\n
\r\nint main()\r\n{\r\n    char *months[] =\r\n    {\r\n        \"January\", \"janvier\",\r\n        \"February\", \"fevrier\",\r\n        \"March\", \"mars\",\r\n        \"April\", \"avril\",\r\n        \"May\", \"mai\",\r\n        \"June\", \"juin\",\r\n        \"July\", \"julliet\",\r\n        \"August\", \"aout\",\r\n        \"September\", \"septembre\",\r\n        \"October\", \"octobre\",\r\n        \"November\", \"novembre\",\r\n        \"December\", \"decembre\",\r\n        NULL, NULL\r\n    };\r\n    char a[16];\r\n    char *b;\r\n\r\n    printf(\"Month in English: \");\r\n    \/* scanf() doesn't monitor overflow! *\/<\/span>\r\n    scanf(\"%s\",a);\r\n    b = key(a,months);\r\n    if( b!=NULL )\r\n        printf(\"'%s' is '%s' in French\\n\",a,b);\r\n    else\r\n        printf(\"'%s' isn't a month name\\n\",a);\r\n\r\n    return(0);\r\n}<\/pre>\n
I dislike using the scanf()<\/em> function for any form of input, but it presents a single statement here instead of my having to craft my own input function. Array a[]<\/code> is fixed to 16 characters (15 text plus the null character), but this limit isn’t tested by the scanf()<\/em> function. If you release such code into the wild, ensure you use a proper text input function complete with bounds-checking.<\/p>\n
Click here<\/a> to view the full code on GitHub. Here’s a sample run:<\/p>\n
Month in English: May
\n'May' is 'mai' in French<\/code><\/p>\n
And a sample run with bogus input:<\/p>\n
Month in English: Bogus
\n'Bogus' isn't a month name<\/code><\/p>\n
By using an associative array, even a phony one in C, I’m able to finally reach the goal I desired in this series’ original post<\/a>: To create a pair of arrays to translate from English to French.<\/p>\n
This phony associative array concept can be expanded further, but not without some modification. Functions can be built to create the array, assigning keys and values. To accomplish this task, it’s better to create a linked list of dictionary structures with key and value members, as was suggested in an earlier comment in this series.<\/p>\n","protected":false},"excerpt":{"rendered":"
The beauty of an associative array is that you don’t need to know an element’s number, just its associated key name. 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-5917","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\/5917","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=5917"}],"version-history":[{"count":5,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5917\/revisions"}],"predecessor-version":[{"id":5929,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5917\/revisions\/5929"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5917"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=5917"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=5917"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}