diff --git a/reference/array/functions/array-column.xml b/reference/array/functions/array-column.xml index de42f8fe5..59660c241 100644 --- a/reference/array/functions/array-column.xml +++ b/reference/array/functions/array-column.xml @@ -1,7 +1,6 @@ - - + @@ -23,6 +22,14 @@ en el array devuelto por los valores de la columna index_key del array de entrada. + + array se trata como una lista de filas, cada una de las cuales es + a su vez un array o un objeto; una columna es la entrada o propiedad que + column_key nombra en cada fila. + Las filas que no son ni un array ni un objeto, y las filas en las que dicha entrada + o propiedad está ausente, se omiten sin diagnóstico. + Las claves de array nunca se conservan. + &reftitle.parameters; @@ -31,27 +38,31 @@ array - - Un array multidimensional o un array de objetos a partir del cual - se extrae una columna de valor. Si se proporciona un array de objetos, - entonces las propiedades públicas pueden ser directamente extraídas. - Para que las propiedades protegidas o privadas sean extraídas, - la clase debe implementar las dos métodos mágicos - __get y __isset. - + + Una lista cuyas filas son arrays u objetos, a partir de la cual se extrae + una columna de valores. Si una fila es un objeto, las propiedades públicas + se leen directamente. Para que una propiedad no accesible públicamente sea leída, + la clase debe implementar tanto los métodos mágicos + __get() como + __isset(): sin + __isset() la fila se omite, y con + __isset() pero sin + __get() se lanza un + Error. + column_key - + La columna de valores a devolver. Este valor puede ser la clave - entera de la columna que se desea recuperar, o bien el + entera de la columna a recuperar, o bien el nombre de la clave para un array asociativo o el nombre de la propiedad. - También puede valer &null; para devolver el array completo o - los objetos (esto puede ser útil en conjunción con el argumento + También puede valer &null; para devolver las filas completas + (esto puede ser útil en conjunción con el argumento index_key para reindexar el array). - + @@ -71,10 +82,11 @@ &reftitle.returnvalues; - + Devuelve un array de valores que representan una sola columna desde el - array de entrada. - + array de entrada. Si column_key es &null;, se devuelven + las propias filas. + &reftitle.changelog; @@ -96,6 +108,20 @@ una TypeError en su lugar. + + 7.1.0 + + Ahora se respeta la visibilidad de las propiedades. Anteriormente, las propiedades + protegidas y privadas se leían directamente. + + + + 7.0.0 + + Las filas de array ahora también pueden ser objetos, + además de arrays. + + @@ -255,8 +281,8 @@ Array Recupera la columna de nombres desde la propiedad privada "name" de un - objeto utilizando los métodos mágicos <function>__isset</function> y - <function>__get</function> + objeto utilizando los métodos mágicos <link linkend="object.isset">__isset()</link> + y <link linkend="object.get">__get()</link> - Si __isset no está definido, entonces se devolverá un array - vacío. + Si __isset() no está definido, el objeto + no contribuye con ninguna entrada al array devuelto.