$rtrim (Aparar à Direita)
Última atualização: 2026-10-09
$rtrim (Aparar à Direita)
$rtrim remove espaço em branco, ou caracteres do conjunto fornecido em chars, da direita (fim) de uma string — a variante do lado direito de $trim. Ótimo para espaços finais, quebras de linha perdidas ou separadores finais. chars tem como padrão o espaço em branco e pode ser substituído por um conjunto personalizado. Entrada null ou ausente resulta em null.
| Categoria | String |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $rtrim: { 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 à direita removidos; null se a entrada for null.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $rtrim: remover quebras de linha finais das linhas de log
db.logs.aggregate([
{ $project: { msg: { $rtrim: { input: '$raw', chars: '\r\n' } } } }
])
Saída:
{ "_id": 1, "msg": "done" }
{ "_id": 2, "msg": "ok" }
📌 Notas
- Apenas a extremidade direita; a esquerda permanece intocada
- chars tem como padrão o espaço em branco; substitua para terminações personalizadas
- chars explícito pode mirar CRLF final e similares
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQuebras de linha finais podem ser removidas?
ASim — passe os caracteres CR/LF via chars.
QApenas o lado direito?
ASim — $rtrim lida apenas com o fim da string.
QComo combina com $ltrim?
AAplique $ltrim e depois $rtrim — equivalente a $trim.