$indexOfArray (Encontrar Índice de Elemento no Array)

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

$indexOfArray (Encontrar Índice de Elemento no Array)

$indexOfArray retorna o índice da primeira ocorrência de um valor em um array, ou -1 quando ausente. Usos típicos incluem verificar se uma tag existe e localizar um elemento específico para lê-lo com $arrayElemAt. Argumentos opcionais restringem a busca a um intervalo de índices start/end. É a contraparte em array de $indexOfBytes/$indexOfCP, que operam em strings. A correspondência usa igualdade estrita, então objetos devem corresponder como um todo.

📝 Sintaxe

{ $indexOfArray: [ <array>, <valor de busca>, <início>, <fim> ] }

⚙️ Parâmetros

Retorno：O índice da primeira correspondência, ou -1 quando não encontrado

▶ Exemplo

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

// $indexOfArray: localizar a tag 'urgent'
db.tasks.aggregate([
  { $project: {
      urgentPos: { $indexOfArray: ['$tags', 'urgent'] }
  } }
])

Saída：

{ '_id': 1, 'urgentPos': 2 }
{ '_id': 2, 'urgentPos': -1 }

📌 Notas

• Apenas a primeira correspondência é retornada; duplicatas posteriores são ignoradas
• O intervalo é fechado à esquerda e aberto à direita: start é inclusivo, end é exclusivo
• Não encontrado resulta em -1, o que pode conduzir verificações de existência

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