Documentación offline PHP master

MongoDB\Driver\Cursor::getId

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

MongoDB\Driver\Cursor::getId

Devuelve el ID del cursor

Descripción#

final public MongoDB\Driver\Cursor::getId(): MongoDB\BSON\Int64
```php

Devuelve el ID de este cursor, que identifica de manera única al cursor en el servidor.

## Parámetros

Esta función no contiene ningún parámetro.

## Valores devueltos

Devuelve el ID de este cursor. El ID se devolverá como un objeto `MongoDB\BSON\Int64`.

## Errores/Excepciones

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

en caso de error durante el análisis de un argumento.

## Historial de cambios

| Versión | Descripción |
|----|----|
| PECL mongodb 2.0.0 | Se cambió el tipo de retorno a `MongoDB\BSON\Int64`. Se eliminó el parámetro `asInt64`. |
| PECL mongodb 1.20.0 | Se desaconsejó devolver un `MongoDB\Driver\CursorId`. Se añadió el argumento `asInt64` para facilitar la migración en versiones futuras. Si `asInt64` es `true`, el ID se devolverá como un `MongoDB\BSON\Int64`. |

## Ejemplos

Ejemplo de `MongoDB\Driver\Cursor::getId`
2]); $bulk = new MongoDB\Driver\BulkWrite; $bulk->insert(['x' => 1]); $bulk->insert(['x' => 2]); $bulk->insert(['x' => 3]); $manager->executeBulkWrite('db.collection', $bulk); $cursor = $manager->executeQuery('db.collection', $query); var_dump($cursor->getId(true)); ?>

```php

Resultado del ejemplo anterior es similar a:

object(MongoDB\BSON\Int64)#5 (1) {
  ["integer"]=>
  string(11) "94810124093"
}

Véase también#

MongoDB\BSON\Int64