[CCA Standards] PHPdoc @return void

[Tristan Lins]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 18.11.2014 um 09:47 schrieb Martin Auswöger:
>> Ich will die ganze Diskussion nicht noch mal durchkochen. Ich
>> will aber 2 Argumente nennen, warum ich der Meinung bin, dass
>> "@return void" durchaus sinnvoll ist.
> 
> Ich wäre auch dafür @return immer anzugeben. Mir würde jedoch
> `@return null` besser gefallen, denn `void` ist eigentlich kein
> Datentyp in PHP und Funktionen ohne Return-Wert geben `NULL`
> zurück.

Das mag vielleicht sein, aber in dem Fall würde ich Logik der
technischen Besonderheiten von PHP vorziehen.

Void ist im übrigen generell kein Datentyp, sondern ein Schlüsselwort
für "keine Daten" bzw. "keinen Datentyp".
http://de.wikipedia.org/wiki/Void_(Schl%C3%BCsselwort)

Daher ist void durchaus korrekt, auch wenn es void als Schlüsselwort
oder Datentyp nicht in PHP gibt.

Außerdem würde @return null wieder dazu führen, dass eine IDE
folgenden Fehler **nicht** findet:

$object = new MyClass(); // aus meinem vorherigen Beispiel
$result = $object->func(); // wirft keinen Fehler,
                       // weil null ja ein gültiger Rückgabewert ist.


- -- 
Tristan Lins - Inhaber, Softwareentwickler
bit3 UG (haftungsbeschränkt)
Bismarckstr. 45 · 56470 Bad Marienberg
info at bit3.de · http://bit3.de · 0261-45093253
Amtsgericht Koblenz, HRB 23386
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQEcBAEBAgAGBQJUawkZAAoJEP7dYl7CqfrdRdsH/RG/AtgEvwNUgxctjOTpnZFU
4B/xj6UNCXL+s7XtLxAmujkGaKXZzBOrk66VcH3rPGq6TlBHv3sH9G93LCFQzSh/
mWXSPASKO7VcXB6GR3wS0DXMoybqMibgwVsSDFj+0mLaWXPiH7Xq6WqMQ4+srk1C
vEROmFg7YtXw3UZHRSGji38hC+W3UABCd+M3CTfoqXRB9UAel0vVUUpmno1Op99d
FAM0xAYInvwz2/1YieUpw2r7EytrvGVWbCtGYb6zYTz8yLCC8vQtN5R6lXyXudCH
w4q4XIz6VMTSoL4j0L/LjyMKPaFZIbyjDAX/ru7LVlmfXiUpwZFnRgs5PJr0YY0=
=n6CO
-----END PGP SIGNATURE-----