$trim (Aparar Ambas as Extremidades)

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

$trim (Aparar Ambas as Extremidades)

$trim remove espaços em branco (espaços, tabulações, quebras de linha) de ambas as extremidades de uma string, ou remove um conjunto personalizado de caracteres fornecido por chars. Serve para limpar entrada do usuário, linhas de log ou campos CSV. Sem chars, apenas espaços em branco são removidos; com chars, todo caractere da extremidade que esteja no conjunto é removido. Entrada null ou ausente resulta em null. Use $ltrim ou $rtrim para apenas uma extremidade.

📝 Sintaxe

{ $trim: { input: <expressão de string>, chars: <conjunto de caracteres> } }

⚙️ Parâmetros

Retorno：A string com espaços removidos; null se a entrada for null.

▶ Exemplo

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

// $trim: limpar nomes inseridos pelos usuários
db.users.aggregate([
  { $project: { name: { $trim: { input: '$name' } } } }
])

Saída：

{ "_id": 1, "name": "Alice" }
{ "_id": 2, "name": "Bob" }

📌 Notas

• O espaço em branco padrão inclui espaços, tabulações, retornos de carro e quebras de linha
• Fornecer chars desativa a remoção padrão de espaço em branco — inclua ambos se necessário
• Para apenas uma extremidade, use $ltrim ou $rtrim

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