From 3cbecfefad239645c876b00002412b1dfc1f7726 Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Wed, 8 Nov 2023 16:11:18 +0000 Subject: [PATCH] Sync Closure docs with EN --- language/predefined/closure/bind.xml | 62 +++++----------- language/predefined/closure/bindto.xml | 76 +++++++------------- language/predefined/closure/call.xml | 17 ++--- language/predefined/closure/construct.xml | 30 +++----- language/predefined/closure/fromcallable.xml | 40 +++++++---- 5 files changed, 82 insertions(+), 143 deletions(-) diff --git a/language/predefined/closure/bind.xml b/language/predefined/closure/bind.xml index 527eb92fa..ac1fb1c24 100644 --- a/language/predefined/closure/bind.xml +++ b/language/predefined/closure/bind.xml @@ -1,8 +1,6 @@ - - + - Closure::bind @@ -10,23 +8,22 @@ Duplicar un cierre con un objeto vinculado y ámbito de clase especificados - + &reftitle.description; - - public static ClosureClosure::bind + + public static ClosurenullClosure::bind Closureclosure - objectnewthis - mixednewscope - "static" + objectnullnewThis + objectstringnullnewScope"static" Este método es una versión estática de Closure::bindTo. Véase la documentación de ese método para más información. - + - + &reftitle.parameters; @@ -39,7 +36,7 @@ - newthis + newThis El objeto al que la función anónima dada debería ser vinculado, o @@ -48,7 +45,7 @@ - newscope + newScope El ámbito de clase a la que asociar el cierre, o @@ -61,40 +58,14 @@ - + &reftitle.returnvalues; - Devuelve un nuevo objeto Closure &return.falseforfailure; + Devuelve un nuevo objeto Closure object, o &null; en caso de error. - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 7.0.0 - - newscope ya no puede ser (un objeto de) una clase - interna, lo que era posible antes de esta versión. - - - - - - - - - + &reftitle.examples; @@ -129,8 +100,8 @@ echo $bcl2(), "\n"; - - + + &reftitle.seealso; @@ -138,9 +109,8 @@ echo $bcl2(), "\n"; Closure::bindTo - - + - + - Closure::bindTo @@ -10,21 +8,20 @@ Duplicar el cierre con un objeto vinculado y ámbito de clase nuevos - + &reftitle.description; - - public ClosureClosure::bindTo - objectnewthis - mixednewscope - "static" + + public ClosurenullClosure::bindTo + objectnullnewThis + objectstringnullnewScope"static" Crea y devuelve una nueva función anónima con el cuerpo y variables vinculadas como ésta, pero posiblemente con un objeto vinculado diferente y un nuevo ámbito de clase. - + El "objeto vinculado" determina el valor que $this tendrá en el cuerpo de la función, y el "ámbito de clase" representa una clase @@ -32,15 +29,15 @@ de acceder la función anónima. Concretamente, los miembros que serán visibles son los mismos que si la función anónima fuese un método de la clase dada como valor del parámetro - newscope. + newScope. - + Los cierres estáticos no pueden tener ningún objeto vinculado (el valor del parámetro - newthis debería ser &null;), pero esta función puede, + newThis debería ser &null;), pero esta función puede, no obstante, usarse para cambiar su ámbito de clase. - + Esta función se asegurará de que a un cierre no estático que tenga una instancia vinculada se le aplique un ámbito y viceversa. En este punto, @@ -48,21 +45,21 @@ estáticos, y los cierres no estáticos y sin ámbito que le son dados una instancia no nula se les aplica un ámbito de clase no especificado. - + Si solamente se quieren duplicar las funciones anónimas, se puede usar cloning en su lugar. - + - + &reftitle.parameters; - newthis + newThis El objeto al que la función anónima dada debería ser vinculado, o @@ -71,7 +68,7 @@ - newscope + newScope El ámbito de la clase a la que se va a asociar el cierre, o @@ -84,40 +81,15 @@ - + &reftitle.returnvalues; - Devuelve el objeto Closure recién creado - &return.falseforfailure; + Devuelve el objeto Closure recién creado, + o &null; en caso de error. - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 7.0.0 - - newscope ya no puede ser (un objeto de) una clase - interna, lo cual era posible antes de esta versión. - - - - - - - - + &reftitle.examples; @@ -127,6 +99,7 @@ val = $val; } @@ -155,8 +128,8 @@ echo $cl(), "\n"; - - + + &reftitle.seealso; @@ -164,9 +137,8 @@ echo $cl(), "\n"; Closure::bind - - + - + - Closure::call @@ -10,13 +8,13 @@ &reftitle.description; - + public mixedClosure::call - objectnewthis - mixed... + objectnewThis + mixedargs - Vincula temporalmente el cierre a newthis, y lo + Vincula temporalmente el cierre a newThis, y lo llama con cualquier parámetro dado. @@ -24,7 +22,7 @@ &reftitle.parameters; - newthis + newThis El object a vincular al cierre mientras dure la @@ -33,7 +31,7 @@ - ... + args Cero o más parámetros, que serán dados como parámetros al @@ -87,7 +85,6 @@ int(8) - - + - Closure::__construct Constructor que anula la instanciación - + &reftitle.description; - + private Closure::__construct - - + + Este método sólo existe para anular la instanciación de la clase Closure. Los objetos de esta clase se crean del modo descrito en la página funciones anónimas. - + - + &reftitle.parameters; &no.function.parameters; - - - &reftitle.returnvalues; - - Este método no tiene un valor de retorno; simplemente emite un error - (de tipo E_RECOVERABLE_ERROR). - - - - + &reftitle.seealso; @@ -46,9 +35,8 @@ - - + - + - Closure::fromCallable Convierte un 'callable' en un cierre - + &reftitle.description; - + public static ClosureClosure::fromCallable - callablecallable + callablecallback Crea y devuelve una nueva función - anónima desde el callable dado empleando el - ámbito actual. Este método comprueba si callable es + anónima desde el callback dado empleando el + ámbito actual. Este método comprueba si callback es llamable en el ámbito actual, lanzando un TypeError si no lo es. + + + A partir de PHP 8.1.0, + Sintaxis de llamada de primera clase + tiene la misma semántica que este método. + + - + &reftitle.parameters; - callable + callback El «callable» a convertir. @@ -37,17 +42,25 @@ - + &reftitle.returnvalues; Devuelve el recién creado Closure o lanza un - TypeError si callable no + TypeError si callback no es llamable en el ámbito actual. - + + &reftitle.seealso; + + Funciones anónimas + Sintaxis de las llamadas de primera clase + + + + -