$arrayElemAt (agregación)

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 5.0, consulta el Procedimientos de actualización de MongoDB 6.0 .

Definición

$arrayElemAt: Novedad en la versión 3.2.
Devuelve el elemento en el índice especificado del arreglo.

Compatibilidad

Puedes usar $arrayElemAt para implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

$arrayElemAt tiene la siguiente sintaxis:

{ $arrayElemAt: [ <array>, <idx> ] }

La expresión <array> puede ser cualquier expresión válida que se resuelva en un arreglo.

La expresión <idx> puede ser cualquier expresión válida que resuelva a un número entero.

Para obtener más información sobre las expresiones, consulta Expresiones.

Comportamiento

Si la expresión <idx> se resuelve en cero o en un número entero positivo, $arrayElemAt devuelve el elemento en la posición idx, contando desde el inicio del arreglo.
Si la expresión <idx> resulta en un número entero negativo, $arrayElemAt devuelve el elemento en la posición idx, contando desde el final del arreglo.
Si idx excede los límites del arreglo, $arrayElemAt no retorna resultado.
Si la expresión <array> se resuelve en un arreglo indefinido, $arrayElemAt devuelve null.

Ejemplo	Resultados
`{ $arrayElemAt: [ [ 1, 2, 3 ], 0 ] }`	`1`
`{ $arrayElemAt: [ [ 1, 2, 3 ], -2 ] }`	`2`
`{ $arrayElemAt: [ [ 1, 2, 3 ], 15 ] }`
`{ $arrayElemAt: [ "$undefinedField", 0 ] }`	`null`

Ejemplo

Una colección llamada users contiene los siguientes documentos:

{ "_id" : 1, "name" : "dave123", favorites: [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", favorites: [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", favorites: [ "pears", "pecans", "chocolate", "cherries" ] }
{ "_id" : 4, "name" : "ty", favorites: [ "ice cream" ] }

El siguiente ejemplo devuelve el primer y último elemento en el arreglo favorites:

db.users.aggregate([
   {
     $project:
      {
         name: 1,
         first: { $arrayElemAt: [ "$favorites", 0 ] },
         last: { $arrayElemAt: [ "$favorites", -1 ] }
      }
   }
])

La operación devuelve los siguientes resultados:

{ "_id" : 1, "name" : "dave123", "first" : "chocolate", "last" : "apples" }
{ "_id" : 2, "name" : "li", "first" : "apples", "last" : "pie" }
{ "_id" : 3, "name" : "ahn", "first" : "pears", "last" : "cherries" }
{ "_id" : 4, "name" : "ty", "first" : "ice cream", "last" : "ice cream" }

Ver también

Volver

$anyElementTrue

$arrayToObject