$ltrim (Aparar à Esquerda)
Última atualização: 2026-10-09
$ltrim (Aparar à Esquerda)
$ltrim remove espaço em branco, ou caracteres do conjunto fornecido em chars, da esquerda (início) de uma string — a variante do lado esquerdo de $trim. Útil para espaços iniciais, indentação ou símbolos de prefixo. chars tem como padrão o espaço em branco; um conjunto personalizado o substitui. Entrada null ou ausente resulta em null. Combinar $ltrim com $rtrim emula $trim.
| Categoria | String |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $ltrim: { input: <expressão de string>, chars: <conjunto de caracteres> } }⚙️ Parâmetros
| input | Obrigatório; a string a processar. |
|---|---|
| chars | Conjunto de caracteres personalizado opcional; espaço em branco por padrão. |
Retorno：A string com espaços à esquerda removidos; null se a entrada for null.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $ltrim: remover espaço em branco inicial das linhas de log
db.logs.aggregate([
{ $project: { msg: { $ltrim: { input: '$raw' } } } }
])Saída：
{ "_id": 1, "msg": "server started" }
{ "_id": 2, "msg": "timeout" }📌 Notas
- Apenas a extremidade esquerda; a direita permanece intocada
- chars tem como padrão o conjunto de espaço em branco
- Combinado com $rtrim emula $trim
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QEle remove apenas o lado esquerdo?
ASim — $ltrim remove apenas o início da string.
QE se o lado direito também tiver espaços?
ASiga com $rtrim, ou apenas use $trim em uma chamada.
QCaracteres personalizados podem ser removidos?
ASim — especifique-os via chars.
