PHP 8.4.0 RC4 available for testing

Collection::removeOne

(No version information available, might only be in Git)

Collection::removeOneLöscht ein Dokument einer Sammlung

Beschreibung

public mysql_xdevapi\Collection::removeOne(string $id): mysql_xdevapi\Result

Löscht das Dokument mit der zugehörigen ID aus der Sammlung. Dies ist eine Kurzform für Collection.remove("_id = :id").bind("id", id).execute().

Parameter-Liste

id

Die ID des zu entfernenden Dokuments. Normalerweise ist dies die _id, die vom MySQL-Server beim Hinzufügen des Datensatzes erzeugt wurde.

Rückgabewerte

Gibt ein Result-Objekt zurück, das verwendet werden kann, um die Anzahl der betroffenen Elemente und die Anzahl der durch die Operation erzeugten Warnungen abzufragen.

Beispiele

Beispiel #1 mysql_xdevapi\Collection::removeOne()-Beispiel

<?php
$session
= mysql_xdevapi\getSession("mysqlx://user:password@localhost");

$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();

$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");

$result = $collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();

// Normalerweise ist die _id aus anderen Quellen bekannt, aber für
// dieses Beispiel rufen wir die generierte ID ab und verwenden sie
$ids = $result->getGeneratedIds();
$alfred_id = $ids[0];

$result = $collection->removeOne($alfred_id);

if(!
$result->getAffectedItemsCount()) {
echo
"Alfred mit der ID $alfred_id wurde nicht entfernt.";
} else {
echo
"Auf Wiedersehen, Alfred, du kannst _id $alfred_id mitnehmen.";
}
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Auf Wiedersehen, Alfred, du kannst _id 00005b6b536100000000000000cb mitnehmen.
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top