Int32 (Inteiro de 32 bits)
Última atualização: 2026-10-09
Int32 (Inteiro de 32 bits)
Int32 é um inteiro com sinal de 32 bits, variando de -2147483648 a 2147483647. No mongosh, um número puro como 42 é um Double, então construa inteiros explicitamente com `Int32(42)`. Use-o para idades, contadores e ids que permanecem pequenos; mude para Long além da faixa de 32 bits.
| Categoria | Tipos BSON |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
Int32(<integer>)
{ age: Int32(30) }
db.users.find({ age: { $gt: Int32(18) } })Retorno：Retorna um inteiro BSON Int32
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// Int32: constrói um inteiro explicitamente
use shop
db.users.insertOne({ name: 'alice', age: Int32(30) })
db.users.find({ age: { $gt: Int32(18) } })Saída：
{ _id: ObjectId('...'), name: 'alice', age: Int32(30) }📌 Notas
- 42 puro no mongosh é um Double; use Int32(42) para um inteiro
- Valores fora da faixa geram erro; mude para Long
- $eq não corresponde a valores mistos Int32 e Double
🏷️ Tags Relacionados
💡 Casos Relacionados
Documentos e BSON: a base dos dados do MongoDB
Inserção de documentos: uma explicação detalhada sobre `insertOne` e `insertMany`
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QInt32 ou Long — como escolher?
AFique dentro de ±2,1 bilhões com Int32; use Long (64 bits) além disso ou para margem de crescimento.
QQue tipo é 42 no mongosh?
AÉ um Double por padrão. Use Int32(42) ou Long(42) para um inteiro.
QO Int32 pode estourar?
ASim — construir um valor além da faixa de 32 bits gera erro; mude para Long.
