@return void или @return null?

Question

[Donald_Duck]

Здравствуйте! Не могу понять когда использовать @return void.

Допустим, есть какая-то функция, которая явно возвращает null

/**
 * @return null
 */
function a() {
    // Какой-то код в этой функции и дальше return
    return null;
}

А есть такие функции, которые возвращают null не явно

/**
 * @return null или void?
 */
function b() {
    // Какой-то код в этой функции
}

/**
 * @return null или void?
 */
function c() {
    // Какой-то код в этой функции и дальше return
    return;
}

Comments

[Сергей delphinpro]

не надо писать void никогда.
В языке нет такого понятия.
К тому же оно означает "никакой тип" или "ничего не возвращает".
Но мы то знаем что неявно функция в php возвращает тип null. А это уже не void.

[Donald_Duck]

Сергей, Тогда такой вопрос: зачем void вообще указан в документации phpdoc, если он по сути является бесполезным и нигде не используется?

[Сергей delphinpro]

Donald_Duck, возможно я не совсем прав. Вот тут парни тоже затрагивали тему
https://ru.stackoverflow.com/questions/451996/В-ка...
Но всё же считаю, что void излишен.

[DevMan]

Сергей, https://wiki.php.net/rfc/void_return_type

[Сергей delphinpro]

DevMan, Всё таки приняли. ну тогда ok.

Answer 1

[DevMan]

документация пишется же для людей, соответственно, она должна людям о чем-то говорить.

@return void говорит нам, что функция ничего не возвращает, поэтому использовать ее вызов, допустим в выражениях, не имеет смысла.

@return null говорит что мы намеренно возвращаем null и у нас для этого есть причины.

по теме - https://www.dereuromark.de/2015/10/05/return-null-...

Comments

[Сергей delphinpro]

@return void говорит нам, что функция ничего не возвращает,

Почему бы просто не опустить эту запись?

[DevMan]

Сергей, потому что явное лучше неявного.

[DevMan]

Сергей, особенно, когда функция занимает 3 экрана))

[Donald_Duck]

Т.е. для функций b() и c() будет void, а для функции a() null, правильно я понял?

[DevMan]

Donald_Duck, да.

[Donald_Duck]

DevMan, Спасибо! :)

[DevMan]

Donald_Duck, пжл
https://wiki.php.net/rfc/void_return_type если ещё не видели.

Answer 2

[roxik]

Нет, все же правильно возвращать null.

Comments

[Donald_Duck]

Тогда где использовать void?

[roxik]

Donald_Duck, зачем вам использовать void? Если вам ничего не нужно вернуть, то ничего не возвращайте.

[Saboteur]

void это неизвестный тип данных. Вы можете объявить функцию с типом void, чтобы потом вы могли возвращать int/char/null/array, но делать return void - это вы что именно возвращаете?

[Donald_Duck]

Saboteur, для случаев когда функция может возвращать много разных типов есть же mixed?

[roxik]

Donald_Duck, да, mixed. Void когда ничего возвращать не нужно, но и писать return в функции не нужно, это просто функция для обработки чего-то.

А null например когда нужно вернуть значение, но оно не найдено, либо когда нужно остановить выполнение функции после какого-то условия.