Códigos de saída Python

Se você já trabalhou em um sistema UNIX, provavelmente está familiarizado com o conceito de um código de saída. Se você não estiver, vamos fazer uma recapitulação rápida. Um código de saída refere -se a um código de saída específico retornado por um comando, script ou programa após a execução. Um código exclusivo é usado para indicar o status do processo depois de concluir a execução. O status do processo pode ser bem -sucedido, falha ou outra condição. Portanto, o papel dos códigos de saída é indicar como o processo se comportou.

Com isso fora do caminho, vamos explorar os códigos de saída do Python, como eles funcionam e como você pode usá -los em seus programas.

Códigos de saída padrão python

Python tem apenas dois códigos padrão, eu.e., um e um zero. O código de saída de 0 significa que o processo foi executado e saiu com sucesso. Isso significa que nenhum erro foi encontrado. Por outro lado, um código de erro 1 indica que o processo saiu com uma falha. Vamos dar uma olhada em um programa muito simples que apenas imprime a string “Bem -vindo ao Linuxhint!”.

print ("Bem -vindo ao Linuxhint!")

Como você pode imaginar, se executarmos o programa acima, ele será executado com sucesso.

$ python exit_codes.py
Bem -vindo ao Linuxhint!

Podemos ver que o programa retorna a saída desejada. Nos sistemas Unix, podemos usar o comando ECHO seguido pela variável do ambiente ?. Essa variável de ambiente permite obter o código de saída do último comando executado.

No nosso caso, o último comando é o programa Python:

$ echo $?
0

Observe que o comando acima retorna 0. Isso mostra que nosso programa Python é executado com sucesso.

Você já personalizou seu shell e ele retorna um símbolo vermelho se o comando anterior falhar? Sim, ele usa o código de saída para fazer isso.

Agora vamos dar outro exemplo:

print ("Bem -vindo ao Linuxhint!"

Observe algo errado com o programa acima?

No exemplo acima, o código acima está faltando o suporte de fechamento para a função de impressão. Portanto, se executarmos o programa acima, ele falhará e retornará um erro.

$ python exit_codes.py
Arquivo "/Users/UserName/Exit_codes.py ", linha 2
^
SyntaxError: EOF inesperado durante a análise

Aqui, podemos ver claramente que o programa falha e retorna um erro.

Vamos agora verificar o código de saída.

eco $?
1

Você adivinhou; O comando retorna um código de saída 1. Isso mostra que o programa anterior falhou miseravelmente.

Códigos de saída personalizados do Python - o módulo SYS

Um dos módulos mais úteis que incentivo os colegas geeks de Python a aprender é o módulo SYS.

É um ótimo módulo que está embutido na biblioteca padrão do Python, mas fornece funcionalidades excepcionais do sistema.

Elogio suficiente; Podemos usar uma das funções do módulo SYS para criar códigos de saída personalizados em nossos programas Python.

A função é chamada de exit () e tem sintaxe como a mostrada abaixo:

sys.saída ([arg])

Como você pode dizer, a função tem uma sintaxe relativamente simples.

Ele permite especificar o parâmetro arg, que é opcional. Pode ser um número inteiro ou qualquer objeto suportado.

Se o argumento fornecido for um número inteiro zero ou nenhum, é considerado uma execução bem -sucedida. Para qualquer outro valor acima de zero, indica terminação anormal.

Embora dependa do sistema, o valor do código de saída pode variar de 0 a 127.

Você também pode passar uma string que será exibida quando o programa sair.

Veja o programa de exemplo abaixo que retorna um código de saída de 125.

da saída de importação do sistema
impressão ("oi!")
saída (125)
Print ("Bem -vindo ao Linuxhint")

No programa de exemplo acima, começamos importando a função de saída do módulo SYS.

Em seguida, usamos a declaração de impressão para imprimir algum texto na tela.

Para a parte importante, usamos a função de saída e passamos o código de saída como 125.

Nota: Assim que o Python encontrar a função EXIT (), ele terá imediatamente o programa e retornará o código ou mensagem de saída especificada.

Podemos verificar isso executando o programa como:

$ python3 exit_codes.py
Oi!

Podemos ver na saída acima que a segunda declaração de impressão não executa.

Vamos verificar o código de saída como:

$ echo $?
125

Podemos ver que o código de saída é 125, conforme especificado em nosso programa.

Considere o exemplo abaixo que imprime uma string em vez de um código de saída.

da saída de importação do sistema
impressão ("oi!")
saída ("Programa terminou inesperadamente")
Print ("Bem -vindo ao Linuxhint")

Nesse caso, estamos usando uma string literal como o parâmetro arg dentro da função. Depois de executar o programa:

$ python3 exit_codes.py
Oi!

Programa terminou inesperadamente

Podemos ver que o programa imprime a mensagem antes da função de saída e a da função de saída.

Você consegue adivinhar qual é o código de saída do programa acima? Vamos ver:

$ echo $?
1

Sim, é um. Quaisquer terminações anormais do programa que não forneçam seus próprios códigos personalizados receberão um código de saída de 1.

Nota: Use a função de saída quando precisar encerrar seu programa imediatamente.

Conclusão

E com isso, chegamos ao fim do nosso tutorial. Neste artigo, aprendemos como os códigos de saída do Python funcionam e como criar códigos de saída personalizados usando o módulo SYS.

Codificação feliz e, como sempre, obrigado por ler!!