Why Using return codes? - Purpose & Use Cases

The Big Idea

What if your program could tell you exactly when and why it fails, instead of leaving you guessing?

The Scenario

Imagine you write a program that calls many functions, but you have no way to know if each function worked correctly or failed. You just guess or check manually by printing messages everywhere.

The Problem

This manual way is slow and confusing. You might miss errors, or your program might continue running with wrong data. It's like driving blindfolded, hoping you don't crash.

The Solution

Using return codes lets each function tell you exactly if it succeeded or failed. Your program can then decide what to do next, like fixing the problem or stopping safely.

Before vs After

✗ Before

void doTask() {
    // no feedback if error
    performStep1();
    performStep2();
}

✓ After

int doTask() {
    if (performStep1() != 0) return -1;
    if (performStep2() != 0) return -2;
    return 0;
}

What It Enables

It enables your program to handle errors clearly and safely, making your code more reliable and easier to fix.

Real Life Example

Think of a vending machine: it returns a code if it's out of snacks or if the payment failed, so it can show the right message or refund your money.

Key Takeaways

Manual error checking is confusing and risky.

Return codes give clear success or failure signals.

This helps programs handle problems safely and predictably.

Practice

1. What does a return code of 0 usually mean in C functions?

easy

A. The function completed successfully

B. The function encountered an error

C. The function did not run

D. The function returned a pointer

Solution

1. Step 1: Understand return codes meaning

   In C, a return code of 0 typically means success or no error.

2. Step 2: Interpret the code 0

   Since 0 means success, the function completed its task without problems.

3. Final Answer:

   The function completed successfully -> Option A

4. Quick Check:

   Return code 0 = success [OK]

Hint: Remember: 0 means success, non-zero means error [OK]

Common Mistakes:

• Thinking 0 means error
• Confusing return code with function output
• Assuming non-zero means success

2. Which of the following is the correct way to return an error code from a C function?

easy

A. return 0;

B. return 'error';

C. return -1;

D. return true;

Solution

1. Step 1: Identify valid return types for error codes

   Return codes are integers, so returning a number like -1 is valid for error.

2. Step 2: Check each option

   return 0; returns 0 (success), B returns a multi-char constant (invalid), C returns true (boolean, invalid in C), D returns -1 (valid error code).

3. Final Answer:

   return -1; -> Option C

4. Quick Check:

   Use integer codes for errors [OK]

Hint: Return integer codes; negative often means error [OK]

Common Mistakes:

• Returning strings instead of integers
• Using boolean values in C return codes
• Returning 0 for errors

3. What will be the output of this C program?

#include <stdio.h>
int check(int x) {
    if (x > 0) return 0;
    else return 1;
}
int main() {
    int result = check(-5);
    printf("Return code: %d\n", result);
    return 0;
}

medium

A. Return code: 1

B. Return code: -5

C. Return code: 0

D. No output

Solution

1. Step 1: Analyze the check function behavior

   If x > 0, it returns 0; otherwise, it returns 1.

2. Step 2: Apply input value -5

   Since -5 is not greater than 0, the function returns 1.

3. Final Answer:

   Return code: 1 -> Option A

4. Quick Check:

   Input -5 <= 0, so return 1 [OK]

Hint: Check conditions carefully to find returned code [OK]

Common Mistakes:

• Assuming negative input returns 0
• Confusing return value with input
• Ignoring else branch

4. Identify the error in this C function that uses return codes:

int process(int val) {
    if (val == 0)
        return 0;
    else
        return;
}

medium

A. Using 0 as success code

B. No error, code is correct

C. Function should return void

D. Missing return value in else branch

Solution

1. Step 1: Check function return type and return statements

   The function returns int, so every return must have an int value.

2. Step 2: Identify missing return value

   The else branch has 'return;' without a value, which is invalid for int return type.

3. Final Answer:

   Missing return value in else branch -> Option D

4. Quick Check:

   int functions must return int always [OK]

Hint: Every return in int function must return int value [OK]

Common Mistakes:

• Returning nothing in non-void function
• Confusing void and int return types
• Ignoring compiler warnings

5. You want to write a function int saveData() that returns 0 on success, 1 if file not found, and 2 if write error. Which is the best way to handle these return codes in main()?

hard

A. Ignore the return code and always print "Success"

B. Check if return code is 0, else print error message based on code

C. Return the code from main without checking

D. Use return codes only for debugging, not in main

Solution

1. Step 1: Understand return codes purpose

   Return codes help main know if saveData succeeded or failed and why.

2. Step 2: Choose proper handling in main

   Main should check if return code is 0 (success), else print specific error messages for 1 or 2.

3. Final Answer:

   Check if return code is 0, else print error message based on code -> Option B

4. Quick Check:

   Use return codes to handle errors clearly [OK]

Hint: Check return codes to handle errors clearly [OK]

Common Mistakes:

• Ignoring return codes in main
• Printing success without checking
• Using return codes only for debugging