$substr (agregación)

Definición

$substr

Obsoleto desde la 3.4 versión: $substr ahora es un alias $substrBytes para.

Devuelve una subcadena de una cadena, comenzando en una posición de índice especificada e incluyendo el número especificado de caracteres. El índice se basa en cero.

$substr tiene la siguiente sintaxis:

{ $substr: [ <string>, <start>, <length> ] }

Los argumentos pueden ser cualquier expresión válida, siempre que el primero se resuelva en una cadena y el segundo y el tercero en enteros. Para más información sobre expresiones, consulte Expresiones.

Comportamiento

Si <start> es un número negativo, $substr devuelve una string vacía "".

Si <length> es un número negativo, devuelve una subcadena que comienza en el índice especificado e incluye el resto de la$substr cadena.

$substr sólo tiene un comportamiento bien definido para cadenas de caracteres ASCII.

Ejemplo

Considere una colección inventory con los siguientes documentos:

{ "_id" : 1, "item" : "ABC1", quarter: "13Q1", "description" : "product 1" }
{ "_id" : 2, "item" : "ABC2", quarter: "13Q4", "description" : "product 2" }
{ "_id" : 3, "item" : "XYZ1", quarter: "14Q2", "description" : null }

La siguiente operación utiliza el operador para separar $substr el quarter valor en un yearSubstring y quarterSubstring un:

db.inventory.aggregate(
   [
     {
       $project:
          {
            item: 1,
            yearSubstring: { $substr: [ "$quarter", 0, 2 ] },
            quarterSubstring: { $substr: [ "$quarter", 2, -1 ] }
          }
      }
   ]
)

La operación devuelve los siguientes resultados:

{ "_id" : 1, "item" : "ABC1", "yearSubstring" : "13", "quarterSubstring" : "Q1" }
{ "_id" : 2, "item" : "ABC2", "yearSubstring" : "13", "quarterSubstring" : "Q4" }
{ "_id" : 3, "item" : "XYZ1", "yearSubstring" : "14", "quarterSubstring" : "Q2" }