diff --git a/language/control-structures/finally.xml b/language/control-structures/finally.xml index 950c00b79..2be5fd938 100644 --- a/language/control-structures/finally.xml +++ b/language/control-structures/finally.xml @@ -1,5 +1,5 @@ - + finally @@ -182,6 +182,56 @@ finally catch ]]> + + Una sentencia &return; en un bloque &finally; también descarta cualquier + excepción que se esté propagando cuando se ejecuta el bloque &finally;: + una excepción lanzada en el bloque &try; que no es capturada, + o una excepción lanzada o relanzada en un bloque &catch;. + No se informa de ningún error, y la función devuelve el valor del bloque + &finally; como si no se hubiera lanzado ninguna excepción. + + + Un &return; en un bloque &finally; descarta una excepción relanzada + +getMessage(), "\n"; + throw $e; + } finally { + echo 'Dentro de finally', "\n"; + return 'finally'; + } +} + +try { + echo process(), "\n"; +} catch (Exception $e) { + echo 'Esto nunca se alcanza', "\n"; +} +]]> + + &example.outputs; + + + + + + A diferencia de &return;, salir de un bloque &finally; con una sentencia + break, + continue + o goto + no está permitido, y produce un error fatal en tiempo de compilación. + Los bucles contenidos por completo dentro del bloque &finally; pueden seguir + utilizando break y continue. + diff --git a/language/oop5/property-hooks.xml b/language/oop5/property-hooks.xml index 62a4efd46..ae4ad4741 100644 --- a/language/oop5/property-hooks.xml +++ b/language/oop5/property-hooks.xml @@ -1,5 +1,5 @@ - + Hooks de propiedad @@ -410,6 +410,153 @@ class Person { Trabajar solo con elementos del array requiere atención especial. + + <function>isset</function>, <function>empty</function> y <function>unset</function> + + Cuando se utiliza isset o empty sobre una + propiedad que tiene un hook get, se llama al hook y + se comprueba el valor que devuelve en lugar del valor de respaldo de la propiedad. + isset devuelve &true; si ese valor no es &null;, + y empty devuelve &true; si ese valor es igual a &false;. + Esto es intencionado: un hook get puede calcular o inicializar + el valor cuando se lee, de modo que el código externo a los hooks de la propiedad + no puede observar directamente el valor de respaldo. + + + Como consecuencia, si el hook get lee un valor de respaldo + que no ha sido inicializado, utilizar isset o + empty sobre la propiedad lanza un Error, + igual que lo hace la lectura de la propiedad. + Lo mismo se aplica al + operador de fusión de null. + + + <function>isset</function> sobre una propiedad con un hook <literal>get</literal> + + $this->title ?? 'Untitled'; + } + + public string $author { + get => ucfirst($this->author); + set => $this->author = $value; + } +} + +$article = new Article(); + +// El valor de respaldo es null, pero el hook get devuelve 'Untitled'. +var_dump(isset($article->title)); + +// El hook get lee un valor de respaldo no inicializado. +try { + var_dump(isset($article->author)); +} catch (Error $e) { + echo $e->getMessage(), "\n"; +} +?> +]]> + + &example.outputs; + + + + + + Si una propiedad "backed" no tiene un hook get, + isset y empty comprueban directamente + el valor de respaldo, como hacen con una propiedad sin hooks. + En una propiedad virtual que no tiene un hook get, + lanzan un Error, porque la propiedad no se puede leer. + + + Dentro de los hooks de una propiedad, $this->propName hace referencia al + valor de respaldo de esa propiedad, por lo que isset($this->propName) comprueba + directamente el valor de respaldo. + Un hook get puede utilizarlo para gestionar un valor de respaldo no inicializado. + A menudo es más sencillo dar a la propiedad un valor por omisión, como &null;. + + + Gestión de un valor de respaldo no inicializado + + $this->subtitle !== null ? ucfirst($this->subtitle) : null; + } + + // El hook get comprueba su propio valor de respaldo. + public string $author { + get => isset($this->author) ? ucfirst($this->author) : 'Anonymous'; + set => $this->author = $value; + } +} + +$article = new Article(); + +var_dump(isset($article->subtitle)); +var_dump(isset($article->author)); +var_dump($article->author); +?> +]]> + + &example.outputs; + + + + + + Una propiedad que tiene hooks no se puede destruir. + Utilizar unset sobre ella lanza un Error, + tanto si la propiedad es "backed" como virtual, e incluso cuando + unset se llama desde dentro de la clase o de uno de sus hooks. + + + <function>unset</function> sobre una propiedad con hooks + + $this->h * $this->w; + } + + public function __construct(public int $h, public int $w) {} +} + +$r = new Rectangle(4, 5); + +try { + unset($r->area); +} catch (Error $e) { + echo $e->getMessage(), "\n"; +} +?> +]]> + + &example.outputs; + + + + + Herencia diff --git a/reference/var/functions/empty.xml b/reference/var/functions/empty.xml index 47dfdfa3c..7333382d1 100644 --- a/reference/var/functions/empty.xml +++ b/reference/var/functions/empty.xml @@ -1,6 +1,6 @@ - + @@ -150,6 +150,15 @@ bool(false) será llamado, si existe. + + + Al utilizar empty sobre una propiedad que tiene un hook + get, se llama al hook y se comprueba el valor que devuelve. + Consulte los + hooks de propiedad + para más detalles. + + &reftitle.seealso; diff --git a/reference/var/functions/isset.xml b/reference/var/functions/isset.xml index 59185bdf2..70f2b0e13 100644 --- a/reference/var/functions/isset.xml +++ b/reference/var/functions/isset.xml @@ -1,5 +1,5 @@ - + @@ -182,6 +182,15 @@ bool(false) si existe. + + + Al utilizar isset sobre una propiedad que tiene un hook + get, se llama al hook y se comprueba el valor que devuelve. + Consulte los + hooks de propiedad + para más detalles. + + diff --git a/reference/var/functions/unset.xml b/reference/var/functions/unset.xml index c37e14d81..acfd61880 100644 --- a/reference/var/functions/unset.xml +++ b/reference/var/functions/unset.xml @@ -1,5 +1,5 @@ - + @@ -210,6 +210,14 @@ unset($foo1, $foo2, $foo3); será llamado, si existe. + + + Utilizar unset sobre una propiedad que tiene hooks + lanza un Error. Consulte los + hooks de propiedad + para más detalles. + +