Error handling with return codes · Tratamento de erros com códigos de retorno
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 não tem try/except
- Alguns idiomas lançam exceções quando algo dá errado. C não tem exceções.
- Em vez disso, uma função C reporta problemas através do seu valor de retorno — um código de status.
- O caller verifica esse código após cada chamada e decide o que fazer.
Return a status code
- A common rule: return
0for success and a negative number like-1for failure. - So
int do_thing(...)returns0when it worked,-1when it could not. - The real "answer" is then handed back a different way (see the next step).
Retornar um código de status
- Uma regra comum: retorne
0para sucesso e um número negativo como-1para falha. - Então
int do_thing(...)retorna0quando funcionou,-1quando não pôde. - O verdadeiro "resposta" é então passado de outra forma (veja o próximo passo).
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
-1and simply leaves that variable alone.
Reportando a resposta através de out-pointer
- Se o valor de retorno é um código de status, onde vai o resultado real? Através de um out-pointer.
- O caller passa o endereço de uma variável; a função escreve a resposta com
*. - Em caso de falha, a função retorna
-1e simplesmente deixa aquela variável inalterada.
Sentinels for "no value"
- A sentinel is a special value that means "nothing here":
-1for an index,NULLfor 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.
Sentinelas para "sem valor"
- Uma sentinela é um valor especial que significa "nada aqui":
-1para um índice,NULLpara um ponteiro. - Funções usam sentinelas para que o caller possa distinguir sucesso de falha com uma verificação simples.
- Sempre verifique a sentinela antes de confiar no resultado.
#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;
}
Common mistakes
- Return a non-zero code from
mainto signal an error. - Check the return value of any function that can fail.
Erros comuns
- Retorne um código não-zero em vez de
mainpara sinalizar um erro. - Verifique o valor retornado de qualquer função que possa falhar.
Now you try
- Return
0on success and-1on 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.
Agora você tenta
- Retorne
0no sucesso e-1na falha, e escreva a resposta real através do out-pointer. - Na falha, não toque no out-pointer. Não escreva um
main— o checker fornece um.
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 · não write a main. · Complete int safe_div(int a, int b, int *result): se b for 0, retorne -1 e deixe *result inalterado. Caso contrário, armazene a / b em *result e retorne 0. Não escreva um main.
Click Run to see the output here. · Clique em Executar para ver a saída aqui.
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 · não write a main. · Complete int parse_int(const char *s, int *out): se s for um inteiro válido (dígitos, com um sinal opcional à esquerda -), armazene seu valor em *out e retorne 0; caso contrário, retorne -1. Não escreva um main.
Click Run to see the output here. · Clique em Executar para ver a saída aqui.
Complete int withdraw(int balance, int amount, int *new_balance): if amount is more than balance, return -1. Otherwise set *new_balance to · até balance - amount and return 0. Do not · não write a main. · Complete int withdraw(int balance, int amount, int *new_balance): se amount for maior que balance, retorne -1. Caso contrário, defina *new_balance como balance - amount e retorne 0. Não escreva um main.
Click Run to see the output here. · Clique em Executar para ver a saída aqui.