{"id":5709,"date":"2023-01-14T00:01:15","date_gmt":"2023-01-14T08:01:15","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=5709"},"modified":"2023-01-07T11:11:57","modified_gmt":"2023-01-07T19:11:57","slug":"the-volatile-keyword","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=5709","title":{"rendered":"The volatile<\/em> Keyword"},"content":{"rendered":"

Perhaps the most hilarious keyword in the C language is volatile<\/em>. It’s a data type qualifier, which I discussed in last week’s Lesson<\/a>. But this qualifier doesn’t mean that the data is unstable or risky to use, unlike other things described as “volatile.”
\n
\nLike the other C language type qualifiers — const<\/em>, restrict<\/em>, and _Atomic<\/em> — volatile<\/em> has more to do with the compiler optimizing code than with anything that happens to data once a program is running.<\/p>\n

The direction that volatile<\/em> gives to the compiler is that the data shouldn’t be optimized at all, ever. I mention this specific use in a post<\/a> from a year ago where I recommended using the volatile<\/em> keyword to prevent the compiler from optimizing a routine to zero-out memory.<\/p>\n

2022_01_14-Lesson.c<\/a><\/h3>\n
\r\n#include <stdio.h>\r\n\r\nvoid memzero(void *b, int len)\r\n{\r\n    volatile int x;\r\n    char *a;\r\n\r\n    a = (char *)b;\r\n    for( x=0; x<len; x++)\r\n        *(a+x) = 0;\r\n}\r\n\r\nint main()\r\n{\r\n    struct human {\r\n        char name[32];\r\n        int age;\r\n        float weight;\r\n    } my;\r\n\r\n    memzero(&my,sizeof(struct human));\r\n\r\n    return(0);\r\n}<\/pre>\n
The memzero()<\/em> function is a re-write of the memset()<\/em> function in C, which is considered non-secure: If you want to zero a buffer to erase sensitive information, memset()<\/em> might not do the complete job. The compiler can optimize the function’s guts, in which case memory remains untouched.<\/p>\n
In the code above, the memzero()<\/em> function uses the volatile<\/em> qualifier to ensure that the compiler doesn’t optimize int<\/em> variable x<\/code>. Its value isn’t altered as it loops from zero to len<\/code>, filling buffer b<\/code> with zero values.<\/p>\n
Of course, you can replace the memset()<\/em> function with memset_s()<\/em> to avoid optimization; you need not write your own function, but the memzero()<\/em> function does demonstrate a valid use for the volatile<\/em> qualifier. (The upcoming C23 standard includes the memset_explicit()<\/em> function that uses the original memset()<\/em> function’s arguments, but also guarantees no optimization.)<\/p>\n
The final data qualifier in the list is _Atomic<\/em>, a keyword introduced with the C11 standard (like a few of the other underscore prefix keywords). This keyword creates an atomic data type that can be accessed by multiple threads in a single program.<\/p>\n
I cover threaded programming in another post<\/a>, but not at a level deep enough to discuss how atomic data is used or beneficial. Someday I may further explore this qualifier, but for know just nod knowingly when someone discusses it and say something pithy like, “Certainly atomic qualifiers ease data manipulation for multithreaded activities.” Then quickly change the topic to sports.<\/p>\n","protected":false},"excerpt":{"rendered":"
No, it doesn’t mean that the data will explode at any given moment. 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-5709","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\/5709","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=5709"}],"version-history":[{"count":3,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5709\/revisions"}],"predecessor-version":[{"id":5718,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/5709\/revisions\/5718"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5709"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=5709"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=5709"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}