Что возвращает функция в bash?

Возврат функции в Bash: статус выхода, а не значение

В языке Bash (и в большинстве других шелл-интерпретаторов) функция возвращает не данные или значение, как во многих императивных языках программирования, а целочисленный код состояния выхода (exit status). Это принципиально важное отличие, которое часто вводит новичков в заблуждение.

Что такое "код состояния выхода"?

Это число от 0 до 255, которое функция "возвращает" через ключевое слово return, либо которое является статусом последней выполненной внутри функции команды. Семантика стандартная для командной строки:

• 0 означает успех (true).
• Любое число от 1 до 255 означает неудачу (false) или определенный код ошибки.

Этот код можно прочитать сразу после вызова функции через специальную переменную $?.

#!/bin/bash

my_function() {
    echo "Выполняю действия в функции"
    return 42  # Возвращаем код 42
}

my_function
echo "Код возврата функции: $?"  # Выведет: Код возврата функции: 42

Как "вернуть" данные из функции в Bash?

Поскольку сама функция возвращает только статус, для передачи строковых данных, списков или массивов используются другие механизмы:

1. Вывод в стандартный поток вывода (stdout)

    Функция может "печатать" результат с помощью `echo` или `printf`. Вызывающий код перехватывает этот вывод, например, с помощью подстановки команд `$(...)`.

```bash
#!/bin/bash
get_date() {
    echo "Сегодня: $(date '+%Y-%m-%d')"
}

# Захватываем вывод функции в переменную
current_date=$(get_date)
echo "Переменная содержит: $current_date"
```

2. Изменение переменных в глобальной области видимости

    По умолчанию переменные, объявленные внутри функции, являются глобальными (если не объявлены с помощью `local`). Это позволяет напрямую модифицировать данные.

```bash
#!/bin/bash
result=""

calculate() {
    local a=5 b=3
    result=$((a + b))  # Меняем глобальную переменную
}

calculate
echo "Результат расчета: $result"  # Выведет: 8
```

3. Запись в файл или именованный канал (FIFO)

    Используется для сложных сценариев передачи больших объемов данных.

Ключевые нюансы использования return

• return без аргументов возвращает статус последней выполненной команды внутри функции.
• Если функция завершается без явного return, ее статусом также становится статус последней выполненной в ней команды.
• Код возврата 0 (успех) часто опускают, но его можно указать явно для ясности: return 0.

Пример комплексного использования: возврат статуса И данных

#!/bin/bash
# Функция ищет строку в файле
find_in_file() {
    local file=$1
    local search_term=$2

    if [[ ! -f "$file" ]]; then
        echo "Файл не найден" >&2  # Сообщение об ошибке в stderr
        return 1  # Возвращаем код ошибки
    fi

    grep -q "$search_term" "$file"
    if [[ $? -eq 0 ]]; then
        echo "Строка найдена в файле"
        return 0
    else
        echo "Строка не найдена"
        return 3  # Свой код ошибки для "не найдено"
    fi
}

# Использование
output=$(find_in_file "/etc/passwd" "root")
status=$?

echo "Вывод функции: $output"
if [[ $status -eq 0 ]]; then
    echo "Успех! (статус: $status)"
elif [[ $status -eq 3 ]]; then
    echo "Строка отсутствует (статус: $status)"
else
    echo "Произошла ошибка (статус: $status)"
fi

Вывод

Функция в Bash всегда возвращает целочисленный код завершения (exit status), используемый для проверки на успешность ее выполнения в условных конструкциях и циклах. Для передачи же данных необходимо использовать побочные каналы: стандартный вывод, глобальные переменные или файлы. Понимание этого разделения — краеугольный камень для написания надежных, идиоматичных bash-скриптов.