Error handling with return codes

English

C has no try/except

Some languages throw exceptions when something goes wrong. C does not have exceptions.
Instead, a C function reports trouble through its return value — a status code.
The caller checks that code after every call and decides what to do.

ไทย

C ไม่มี try/except

ภาษาบางภาษา throw exceptions เมื่อเกิดปัญหา C ไม่มี exceptions
แทนที่, C function รายงานปัญหาผ่าน return value — status code
ผู้เรียกตรวจสอบโค้ดนี้หลังทุก call และตัดสินใจว่าจะทำอะไร

A function returns 0 on success or -1 on failure; the caller checks the code

English

Return a status code

A common rule: return 0 for success and a negative number like -1 for failure.
So int do_thing(...) returns 0 when it worked, -1 when it could not.
The real "answer" is then handed back a different way (see the next step).

ไทย

คืนค่า status code

กฎทั่วไป: คืน 0 สำหรับ ความสำเร็จ และเลขลบเช่น -1 สำหรับ ความล้มเหลว
ดังนั้น int do_thing(...) คืน 0 เมื่อทำงานสำเร็จ, -1 เมื่อไม่สามารถทำได้
คำตอบจริงจะถูกส่งกลับมาโดยวิธีอื่น (ดูขั้นตอนถัดไป)

English

Reporting the answer through an out-pointer

If the return value is a status code, where does the real result go? Through an out-pointer.
The caller passes the address of a variable; the function writes the answer with *.
On failure, the function returns -1 and simply leaves that variable alone.

ไทย

รายงานคำตอบผ่าน out-pointer

ถ้า return value เป็น status code, ผลลัพธ์จริงไปที่ไหน? ผ่าน out-pointer
ผู้เรียกส่งที่อยู่ของตัวแปร; ฟังก์ชันเขียนคำตอบด้วย *
เมื่อเกิดข้อผิดพลาด ฟังก์ชันจะส่งค่า -1 กลับไปและไม่เปลี่ยนแปลงตัวแปรนั้น

English

Sentinels for "no value"

A sentinel is a special value that means "nothing here": -1 for an index, NULL for a pointer.
Functions use sentinels so the caller can tell success from failure with a simple check.
Always check for the sentinel before you trust the result.

ไทย

Sentinel สำหรับ "ไม่มีค่า"

Sentinel คือค่าพิเศษที่หมายถึง "ไม่มีอะไรอยู่ที่นี่": -1 สำหรับดัชนี, NULL สำหรับพอยเตอร์
ฟังก์ชันใช้ sentinel เพื่อให้ผู้เรียกสามารถแยกความแตกต่างระหว่างความสำเร็จและความล้มเหลวด้วยการตรวจสอบอย่างง่าย
ตรวจสอบ sentinel เสมอก่อนที่คุณจะเชื่อถือผลลัพธ์

#include <stdio.h>

int safe_div(int a, int b, int *result) {
    if (b == 0) return -1;          // failure: cannot divide by zero
    *result = a / b;                // success: hand back the answer
    return 0;
}

int main(void) {
    int r;
    if (safe_div(10, 2, &r) == 0) {
        printf("%d\n", r);          // 5
    }
    return 0;
}

English

Common mistakes

Return a non-zero code from main to signal an error.
Check the return value of any function that can fail.

ไทย

ข้อผิดพลาดที่พบบ่อย

ส่งรหัสที่ไม่ใช่ main กลับมาเพื่อระบุว่ามีข้อผิดพลาดเกิดขึ้น
ตรวจสอบค่าที่ส่งกลับของฟังก์ชันทุกตัวที่อาจล้มเหลว

English

Now you try

Return 0 on success and -1 on failure, and write the real answer through the out-pointer.
On failure, do not touch the out-pointer. Do not write a main — the checker provides one.

ไทย

ลองดูเลย

ส่ง 0 กลับเมื่อสำเร็จ และ -1 กลับเมื่อล้มเหลว แล้วเขียนคำตอบจริงผ่าน out-pointer
เมื่อล้มเหลว อย่าสัมผัส out-pointer อย่า เขียน main — ตัวตรวจสอบจะจัดเตรียมให้

Complete int safe_div(int a, int b, int *result): if b is 0, return -1 and leave *result alone. Otherwise store a / b in *result and return 0. Do not write a main. · ⁨เติม int safe_div(int a, int b, int *result): ถ้า b เป็น 0 ส่ง -1 และทิ้ง *result ไว้เดิม มิฉะนั้นเก็บ a / b ใน *result และส่ง 0 ห้าม เขียน main⁩

/* Return -1 if b == 0; else set *result = a / b and return 0. Do not write main(). */
int safe_div(int a, int b, int *result) {
    *result = 0;
    return 0;   /* check b == 0 first */
}

Click Run to see the output here. · ⁨คลิก Run เพื่อดูผลลัพธ์ที่นี่⁩

Complete int parse_int(const char *s, int *out): if s is a valid integer (digits, with an optional leading -), store its value in *out and return 0; otherwise return -1. Do not write a main. · ⁨เติม int parse_int(const char *s, int *out): หาก s เป็นจำนวนเต็มที่ถูกต้อง (ตัวเลข พร้อมเครื่องหมายลบ - นำหน้าได้) ให้เก็บค่าไว้ใน *out และส่งกลับ 0; มิฉะนั้นส่งกลับ -1. อย่าเขียน main⁩

/* Parse s into *out; return 0 on success, -1 if it is not an integer.
   Do not write main(). */
int parse_int(const char *s, int *out) {
    *out = 0;
    return 0;   /* check each character is a digit */
}

Click Run to see the output here. · ⁨คลิก Run เพื่อดูผลลัพธ์ที่นี่⁩

Complete int withdraw(int balance, int amount, int *new_balance): if amount is more than balance, return -1. Otherwise set *new_balance to balance - amount and return 0. Do not write a main. · ⁨เติม int withdraw(int balance, int amount, int *new_balance): ถ้า amount มากกว่า balance ให้คืนค่า -1. มิฉะนั้น ตั้งค่า *new_balance เป็น balance - amount และคืนค่า 0. ห้าม เขียน main⁩

/* Return -1 if amount > balance; else set *new_balance and return 0.
   Do not write main(). */
int withdraw(int balance, int amount, int *new_balance) {
    *new_balance = 0;
    return 0;   /* check amount > balance first */
}

Click Run to see the output here. · ⁨คลิก Run เพื่อดูผลลัพธ์ที่นี่⁩

C has no try/except

C ไม่มี try/except

Return a status code

คืนค่า status code

Reporting the answer through an out-pointer

รายงานคำตอบผ่าน out-pointer

Sentinels for "no value"

Sentinel สำหรับ "ไม่มีค่า"

Common mistakes

ข้อผิดพลาดที่พบบ่อย

Now you try

ลองดูเลย

Handout · ⁨เอกสารประกอบการเรียน⁩

Log in or create account · ⁨เข้าสู่ระบบหรือสร้างบัญชี⁩

Your subject · ⁨วิชาของคุณ⁩

All sections · ⁨ทุกส่วน⁩

Feedback & help · ⁨ความคิดเห็น &ความช่วยเหลือ⁩