mysqli_stmt::result_metadata

    mysqli_stmt_result_metadata

    (PHP 5, PHP 7, PHP 8)

    mysqli_stmt::result_metadata -- mysqli_stmt_result_metadata — Liefert die Metadaten der Ergebnismenge aus einer vorbereiteten Anweisung

    Beschreibung

    Objektorientierter Stil

    publicmysqli_stmt::result_metadata(): mysqli_result|false

    Prozeduraler Stil

    mysqli_stmt_result_metadata(mysqli_stmt$statement): mysqli_result|false

    Wenn eine an mysqli_prepare() übergebene Anweisung eine Ergebnismenge erzeugt, gibt mysqli_stmt_result_metadata() ein Ergebnisobjekt zurück, das zur Verarbeitung der Metainformationen, z. B. die Gesamtzahl der Spalten und der einzelnen Informationen über die Spalten, verwendet werden kann.

    Hinweis:

    Dieser Ergebnismengenzeiger kann als Argument an Funktionen übergeben werden, die spaltenbasierte Ergebnismengen-Metadaten verarbeiten, z. B.:

    Wenn die Ergebnismenge nicht mehr benötigt wird, sollte sie freigegeben werden. Dazu kann sie an die Funktion mysqli_free_result() übergeben werden.

    Hinweis:

    Die von mysqli_stmt_result_metadata() zurückgegebene Ergebnismenge enthält nur Metadaten, keine Zeilendaten. Die Zeilen können mit der Funktion mysqli_stmt_fetch() über das Anweisungshandle abgerufen werden.

    Parameter-Liste

    statement

    Nur bei prozeduralem Aufruf: ein von mysqli_stmt_init() zurückgegebenes mysqli_stmt-Objekt.

    Rückgabewerte

    Gibt ein Ergebnisobjekt zurück oder false, wenn ein Fehler aufgetreten ist.

    Fehler/Exceptions

    If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR) and the requested operation fails, a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT, a mysqli_sql_exception is thrown instead.

    Beispiele

    Beispiel #1 Objektorientierter Stil

    <?php
    $mysqli     = new mysqli("localhost", "my_user", "my_password", "test");

    $mysqli->query("DROP TABLE IF EXISTS friends");
    $mysqli->query("CREATE TABLE friends (id int, name varchar(20))");

    $mysqli->query("INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");

    $stmt = $mysqli->prepare("SELECT id, name FROM friends");
    $stmt->execute();


    $result = $stmt->result_metadata();


    $field = $result->fetch_field();

    printf("Name der Spalte: %s\n", $field->name);


    $result->close();


    $mysqli->close();
    ?>

    Beispiel #2 Prozeduraler Stil

    <?php
    $link     = mysqli_connect("localhost", "my_user", "my_password", "test");

    mysqli_query($link, "DROP TABLE IF EXISTS friends");
    mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))");

    mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");

    $stmt = mysqli_prepare($link, "SELECT id, name FROM friends");
    mysqli_stmt_execute($stmt);


    $result = mysqli_stmt_result_metadata($stmt);


    $field = mysqli_fetch_field($result);

    printf("Name der Spalte: %s\n", $field->name);


    mysqli_free_result($result);


    mysqli_close($link);
    ?>

    Siehe auch

    To Top