$substrBytes (Substring por Bytes)

Última atualização: 2026-10-09

$substrBytes (Substring por Bytes)

$substrBytes extrai uma substring por posições de bytes UTF-8; tanto start quanto length contam bytes. Serve para texto puramente ASCII (onde bytes equivalem a caracteres) ou casos que exigem controle exato de bytes. Cuidado: com caracteres multibyte como chinês, um limite de byte pode cair no meio de um caractere e corromper a saída — nesse caso, mude para $substrCP baseado em code points. Start negativo resulta em string vazia; length negativo resulta no restante.

📝 Sintaxe

{ $substrBytes: [ <expressão de string>, <início em bytes>, <comprimento em bytes> ] }

⚙️ Parâmetros

Retorno：A substring extraída; null se qualquer argumento for null.

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $substrBytes: primeiros 10 bytes do conteúdo
db.files.aggregate([
  { $project: { head: { $substrBytes: [ '$content', 0, 10 ] } } }
])

Saída：

{ "_id": 1, "head": "hello wor" }
{ "_id": 2, "head": "MongoDB su" }

📌 Notas

• Um caractere chinês ocupa 3 bytes UTF-8; o corte por bytes pode dividir um caractere
• Start negativo resulta em string vazia; length negativo resulta no restante
• Resultados idênticos a $substrCP para ASCII puro

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós