$substrCP (agregación)

Definición

$substrCP

Devuelve la subcadena de una cadena. La subcadena comienza con el carácter en el8 punto de código UTF- (CP) especificado. índice (basado en cero) en la cadena para la cantidad de puntos de código especificados.

$substrCP tiene lo siguiente Sintaxis de expresión del operador:

{ $substrCP: [ <string expression>, <code point index>, <code point count> ] }

Campo	Tipo	Descripción
string expression	string	La cadena de la que se extraerá la subcadena. string expression puede ser cualquier expresión válida siempre que se resuelva en una cadena. Para más información sobre expresiones, consulte Expresiones. Si el argumento se resuelve en un valor de null o hace referencia a un campo que falta, devuelve una cadena$substrCP vacía. Si el argumento no se resuelve en una cadena o null ni hace referencia a un campo faltante, devuelve un$substrCP error.
code point index	Número	Indica el punto de inicio de la subcadena. code point index puede ser cualquier expresión válida siempre que se resuelva en un entero no negativo.
code point count	Número	Puede ser cualquier expresión válida siempre que se resuelva en un entero no negativo o un número que pueda representarse como un entero 2.0 (como).

Ejemplo	Resultados
{ $substrCP: [ "abcde", 1, 2 ] }	"bc"
{ $substrCP: [ "Hello World!", 6, 5 ] }	"World"
{ $substrCP: [ "cafétéria", 0, 5 ] }	"cafét"
{ $substrCP: [ "cafétéria", 5, 4 ] }	"tér"
{ $substrCP: [ "cafétéria", 7, 3 ] }	"ia"
{ $substrCP: [ "cafétéria", 3, 1 ] }	"é"

Comportamiento

El operador utiliza los puntos de código $substrCP $substrBytes para extraer la subcadena. Este comportamiento difiere del operador, que extrae la subcadena por el número de bytes, donde cada carácter ocupa entre uno y cuatro bytes.

Ejemplo

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 }
] )

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

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

db.food.insertMany( [
   { _id: 1, name: "apple" },
   { _id: 2, name: "banana" },
   { _id: 3, name: "éclair" },
   { _id: 4, name: "hamburger" },
   { _id: 5, name: "jalapeño" },
   { _id: 6, name: "pizza" },
   { _id: 7, name: "tacos" },
   { _id: 8, name: "寿司sushi" }
] )

db.food.aggregate(
  [
    {
      $project: {
          "name": 1,
          "menuCode": { $substrCP: [ "$name", 0, 3 ] }
      }
    }
  ]
)

{ _id: 1, name: "apple", menuCode: "app" }
{ _id: 2, name: "banana", menuCode: "ban" }
{ _id: 3, name: "éclair", menuCode: "écl" }
{ _id: 4, name: "hamburger", menuCode: "ham" }
{ _id: 5, name: "jalapeño", menuCode: "jal" }
{ _id: 6, name: "pizza", menuCode: "piz" }
{ _id: 7, name: "tacos", menuCode: "tac" }
{ _id: 8, name: "寿司sushi", menuCode: "寿司s" }