cubrid_db_name — Funktion · PHP-Referenz

Signatur

cubrid_db_name(array $result, int $index): string|false

Beschreibung

cubrid_db_name() extrahiert einen einzelnen Datenbanknamen aus dem Array, das von cubrid_list_dbs() zurückgegeben wurde. Da cubrid_list_dbs() ein Array aller verfügbaren CUBRID-Datenbanken liefert, ermöglicht diese Funktion den indizierten Zugriff auf einzelne Einträge dieses Arrays.

Typisch wird cubrid_db_name() in Kombination mit cubrid_list_dbs() in einer Schleife verwendet, um alle vorhandenen Datenbanken zu iterieren und deren Namen auszugeben oder weiterzuverarbeiten.

Liefert false, wenn der angegebene Index außerhalb des gültigen Bereichs liegt oder das übergebene Array ungültig ist. Die Gültigkeit des Index sollte daher stets überprüft werden, bevor der Rückgabewert weiterverwendet wird.

Parameter

Name	Typ	Default	Beschreibung
$result Pflicht	array		Das Array mit Datenbanknamen, das von `cubrid_list_dbs()` zurückgegeben wurde.
$index Pflicht	int		Der nullbasierte Index des gewünschten Datenbanknamens innerhalb des Ergebnis-Arrays.

Rückgabewert

Typ

string|false

Beschreibung

Gibt den Datenbanknamen als string zurück, wenn der Index gültig ist. Gibt false zurück, wenn der Index außerhalb des gültigen Bereichs liegt oder das übergebene Array ungültig ist.

Beispiele

Alle CUBRID-Datenbanken auflisten

<?php
$conn = cubrid_connect('localhost', 33000, 'demodb', 'dba', '');

if ($conn) {
    $dbList = cubrid_list_dbs($conn);
    $count  = count($dbList);

    echo "Gefundene Datenbanken: $count" . PHP_EOL;

    for ($i = 0; $i < $count; $i++) {
        $name = cubrid_db_name($dbList, $i);
        if ($name !== false) {
            echo "Datenbank #$i: $name" . PHP_EOL;
        }
    }

    cubrid_disconnect($conn);
} else {
    echo 'Verbindung fehlgeschlagen.' . PHP_EOL;
}

Gefundene Datenbanken: 2 Datenbank #0: demodb Datenbank #1: testdb

Gezielter Zugriff auf einen bestimmten Datenbanknamen

<?php
$conn = cubrid_connect('localhost', 33000, 'demodb', 'dba', '');

if ($conn) {
    $dbList = cubrid_list_dbs($conn);

    // Ersten Datenbanknamen abrufen
    $firstName = cubrid_db_name($dbList, 0);

    if ($firstName !== false) {
        echo "Erste Datenbank: " . htmlspecialchars($firstName) . PHP_EOL;
    } else {
        echo 'Kein Eintrag unter diesem Index gefunden.' . PHP_EOL;
    }

    cubrid_disconnect($conn);
}

Erste Datenbank: demodb

// Wichtig · Fallstricke

Hinweis zur Erweiterung: Die CUBRID-Erweiterung für PHP muss installiert und aktiviert sein (extension=cubrid in der php.ini). Da CUBRID eine weniger verbreitete Datenbank ist, ist die Erweiterung auf den meisten Standard-Servern nicht vorinstalliert.

Indexprüfung: Stets sicherstellen, dass der übergebene Index im gültigen Bereich liegt (0 bis count($result) - 1), da cubrid_db_name() bei ungültigem Index false zurückgibt und kein automatisches Abfangen stattfindet.

Siehe auch

cubrid_list_dbs cubrid_connect cubrid_disconnect