size() (Contar no Cursor)
Última atualização: 2026-10-09
size() (Contar no Cursor)
size() retorna o número de documentos em um cursor: `db.users.find().size()`. Sua semântica corresponde em grande parte a count(), exceto que size() respeita um limit() aplicado enquanto count() não. O método está obsoleto — prefira `db.users.countDocuments()`. Conheça-o principalmente para ler código legado.
| Categoria | Cursor |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.find(<filter>).size()Retorno：Número de documentos no cursor (inteiro).
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// size: conta documentos correspondentes
const n = db.users.find({ age: { $gte: 18 } }).size()
print(n)Saída：
42📌 Notas
- Obsoleto — use countDocuments() em código novo
- Diferente de count(), size() honra um limit() anterior
- Não consome o cursor; a iteração pode continuar
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é a diferença entre size e count?
AAmbos contam resultados do cursor; a única diferença é que size() honra limit() enquanto count() o ignora.
QO size() ainda é utilizável?
AFunciona mas está obsoleto; a orientação oficial é countDocuments(), então evite size() em código novo.
QO que find().limit(5).size() retorna?
ARetorna 5 (quando pelo menos 5 correspondem), porque size() considera o limite.
