Menu Docs

Página inicial do Docs → Manual da Biblioteca PHP

MongoDB\UpdateResult::getUpsertedId()

Nesta página

  • Definição
  • Valores de retorno
  • Erros/exceções
  • Veja também

Definição

MongoDB\UpdateResult::getUpsertedId()

Retornar o ID (ou seja valor do campo _id ) do documento atualizado e inserido.

function getUpsertedId(): mixed|null

Valores de retorno

O ID (ou seja valor do campo _id ) do documento atualizado e inserido. Se nenhum documento foi atualizado, null será retornado.

Se o documento tivesse um ID antes do upsering (ou seja, o servidor não precisou gerar um ID), ele conterá seu _id valor de campo . Qualquer ID gerado pelo servidor será um MongoDB\BSON\ObjectId instância.

Erros/exceções

MongoDB\Exception\BadMethodCallException se esse método for chamado e a operação de gravação usar uma write concern não reconhecida.

Veja também

← MongoDB\UpdateResult::getUpsertedCount()
MongoDB\UpdateResult::isAc acknowledged() →

Nesta página