Функция waitstatus_to_exitcode() модуля os в Python

Преобразует статус ожидания процесса в код выхода

Синтаксис:

import os

# Новое в Python 3.9.
os.waitstatus_to_exitcode(status)

Параметры:

• status - статус ожидания процесса.

Возвращаемое значение:

• статус выхода процесса или номер сигнала прервавшего процесс.

Описание:

Функция waitstatus_to_exitcode() модуля os преобразует статус ожидания процесса в код выхода.

В Unix системах:

• Если процесс завершился нормально (если os.WIFEXITED(status) равен True), то возвращает статус выхода процесса os.WEXITSTATUS(status): результат больше или равен 0.
• Если процесс был завершен сигналом (если os.WIFSIGNALED(status) равен True), то возвращает - signum, где signum - номер сигнала, который вызвал завершение процесса os.WTERMSIG(status): результат меньше 0.
• В противном случае вызывает исключение ValueError.

В Windows статус возврата сдвинут вправо на 8 бит.

В Unix, если процесс отслеживается или если os.waitpid() был вызван с опцией os.WUNTRACED, вызывающий должен сначала проверить, истинно ли os.WIFSTOPPED(status).

Функцию os.waitstatus_to_exitcode() нельзя вызывать, если os.WIFSTOPPED(status) имеет значение True.