$substr (operador de expresión)

Definición

$substr

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

Devuelve un substring de un string, comenzando en una posición de índice especificada e incluyendo el número especificado de caracteres. El índice es base 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, $substr devuelve una subcadena que comienza en el índice especificado e incluye el resto de la string.

$substr solo tiene un comportamiento bien definido para cadenas de caracteres ASCII.

Ejemplo

Considere una colección inventory con los siguientes documentos:

db.inventory.insertMany( [
   { _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 $substr para separar el valor de quarter en un yearSubstring y un quarterSubstring:

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" }