$binarySize (Tamanho do Binário)

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

$binarySize (Tamanho do Binário)

$binarySize retorna o tamanho em bytes de dados binários (BinData); dada uma string, retorna o comprimento em bytes UTF-8. É usado para monitoramento de tamanho de anexos, limites de upload ou contabilidade de armazenamento. Entradas que não são nem binárias nem string geram erro. Para strings, o resultado coincide com $strLenBytes. Um binário vazio retorna 0.

📝 Sintaxe

{ $binarySize: <expressão> }

⚙️ Parâmetros

Retorno：O tamanho em bytes como inteiro.

▶ Exemplo

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

// $binarySize: tamanhos de anexos
db.files.aggregate([
  { $project: { size: { $binarySize: '$data' } } }
])

Saída：

{ "_id": 1, "size": 4096 }
{ "_id": 2, "size": 0 }

📌 Notas

• BinData produz bytes; strings produzem bytes UTF-8
• Outros tipos (números, documentos) geram erro
• Um binário vazio retorna 0

🏷️ 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