{"id":3508,"date":"2019-02-23T00:01:25","date_gmt":"2019-02-23T08:01:25","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=3508"},"modified":"2019-02-16T10:24:24","modified_gmt":"2019-02-16T18:24:24","slug":"exit-status-defined-constants","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=3508","title":{"rendered":"Exit Status Defined Constants"},"content":{"rendered":"

The tradition for successfully exiting a command line program is to use return 0;<\/code> or, as I write it, return(0);<\/code>. Zero is the OK value, meaning a program exited cleanly. Other values returned represent specific conditions, not necessarily errors, but information that can be communicated to the operating system or some other program.
\n
\nThe same value is used as the exit()<\/em> function’s argument. Unlike return<\/em> (which is a keyword), you can use exit()<\/em> beyond the main()<\/em> function to bail out. And if you want to get fancy, you can use one of two defined constants available in the stdlib.h<\/code> header file: EXIT_SUCCESS<\/code> and EXIT_FAILURE<\/code>. Here’s some code:<\/p>\n

\r\n#include <stdio.h>\r\n#include <stdlib.h>\r\n\r\nint main()\r\n{\r\n    int d;\r\n\r\n    printf(\"Type a positive number: \");\r\n    scanf(\"%d\",&d);\r\n\r\n    if( d > 0 )\r\n    {\r\n        puts(\"Thanks!\");\r\n        return(EXIT_SUCCESS);\r\n    }\r\n    else\r\n    {\r\n        puts(\"Wrong!\");\r\n        return(EXIT_FAILURE);\r\n    }\r\n}<\/pre>\n
You don’t need to look up the defined constants’ assigned values because I already did: zero for EXIT_SUCCESS<\/code> and 1 for EXIT_FAILURE<\/code>, but that’s not the point of using them.<\/p>\n
Like many things in C, it’s a good idea to use constants wherever possible. That way you can universally change a value by making a single modification to your code. The same thinking holds true for the exit constants. Though it’s highly unlikely, at some point in the future an operating system may accept a value such as -1 meaning “exit successful.” If such a thing came to pass (and it won’t), you would have to update all your legacy code, scanning for return<\/em> and exit()<\/em> points and changing the values as necessary.<\/p>\n
On the other hand, if you create code that uses the exit constants, compiling on the new operating system wouldn’t present an issue; the EXIT_SUCCESS<\/code> constant would be updated for the operating system’s C compiler and no changes would be necessary.<\/p>\n
You can also define these constants in code that doesn’t require the stdlib.h<\/code> header file. The following preprocessor directives do the trick:<\/p>\n
#ifndef EXIT_SUCCESS
\n#define EXIT_SUCCESS 0
\n#endif
\n#ifndef EXIT_FAILURE
\n#define EXIT_FAILURE 1
\n#endif<\/code><\/p>\n
The above directives, either at the start of the source code file or in a user-defined header file, are all that’s needed to create the constants. And when that operating system that requires a -1 return value for a program comes around (and it won’t), you’re ready to compile your compatible code.<\/p>\n
For assistance on the preprocessor directives, see my Preprocessor Directives<\/a> page here on the C For Dummies<\/em> Blog.<\/p>\n","protected":false},"excerpt":{"rendered":"
If you want to be fancy, you can use a defined constant instead of zero or some other number as the main()<\/em> function’s return value. 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-3508","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\/3508","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=3508"}],"version-history":[{"count":3,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3508\/revisions"}],"predecessor-version":[{"id":3515,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3508\/revisions\/3515"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3508"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3508"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3508"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}