CollectionModify::arrayInsert
En esta página
CollectionModify::arrayInsert
Inserta un elemento en un campo de array
Descripción#
public mysql_xdevapi\CollectionModify::arrayInsert(string $collection_field, string $expression_or_literal): mysql_xdevapi\CollectionModify
```php
Añade un elemento a un campo de un documento, ya que varios elementos de un campo están representados en forma de array. A diferencia de mysql_xdevapi\CollectionModify::arrayAppend este método permite especificar dónde se inserta el nuevo elemento definiendo después de qué elemento, mientras que mysql_xdevapi\CollectionModify::arrayAppend siempre añade el nuevo elemento al final del array.
## Parámetros
`collection_field`
Identifica el elemento del array después del cual se insertará el nuevo elemento. El formato de este parámetro es `FIELD_NAME[ INDEX ]` donde \<FIELD_NAME\> es el nombre del campo del documento donde se añadirá el elemento, y \<INDEX\> es el INDEX del elemento en el campo.
El INDEX está basado en cero, por lo que el primer elemento del array tiene un índice de 0.
`expression_or_literal`
El nuevo elemento a insertar después de FIELD_NAME\[ INDEX \]
## Valores devueltos
Un objeto CollectionModify que puede ser utilizado para ejecutar el comando, o para añadir operaciones adicionales.
## Ejemplos
Ejemplo de `mysql_xdevapi\CollectionModify::arrayInsert`
```php
Resultado del ejemplo anterior es similar a:
Array
(
[0] => Array
(
[_id] => 00005b6b5361000000000000010d
[name] => Bernie
[traits] => Array
(
[0] => Friend
[1] => Happy
[2] => Brother
[3] => Human
)
)
)