PDOStatement::bindColumn()

PDOStatement::bindColumn

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDOStatement::bindColumn — Binder en kolumn till en PHP-variabel

Beskrivning

public PDOStatement::bindColumn(

   string|int $column,
   mixed &$var,
   int $type = PDO::PARAM_STR,
   int $maxLength = 0,
   mixed $driverOptions = null

): bool

PDOStatement::bindColumn() säkerställer att en viss variabel binds till en angiven kolumn i resultatuppsättningen från en fråga. Vid varje anrop till PDOStatement::fetch eller PDOStatement::fetchAll uppdateras alla variabler som bundits till kolumner.

Notera: Eftersom information om kolumner inte alltid är tillgänglig för PDO förrän anropet till PDOStatement::execute har gjorts, bör portabla applikationer anropa den här funktionen efter PDOStatement::execute. För att kunna binda en LOB-kolumn som en ström när PgSQL-drivrutinen används, bör dock den här metoden anropas innan PDOStatement::execute. Annars returneras OID för det stora objektet som ett heltal.

Parametrar

column

Antingen kolumnens nummer (1-indexerat) eller kolumnens namn i resultatuppsättningen. Om kolumnnamn används, se till att namnet exakt matchar kolumnens skiftläge så som det returneras av drivrutinen.

var

Namnet på PHP-variabeln som kolumnen ska bindas till.

type

Datatypen för parametern, specificerad av PDO::PARAM_*-konstanterna.

maxLength

En antydan för förallokering av minne.

driverOptions

Valfria drivrutinspecifika parametrar.

Returvärden

Returnerar true om det lyckas eller false om det misslyckas.

Fel/Uppslag

• Utlöser ett fel på nivån E_WARNING om attributet PDO::ATTR_ERRMODE är inställt på PDO::ERRMODE_WARNING.
• Kastar ett PDOException-fel om attributet PDO::ATTR_ERRMODE är inställt på PDO::ERRMODE_EXCEPTION.

Exempel

Exempel 1: Binda kolumner i resultatuppsättningen till PHP-variabler

Genom att binda kolumner i en resultatuppsättning till PHP-variabler blir varje rads data direkt tillgänglig för din applikation. Följande exempel visar hur PDO möjliggör bindning och hämtning av kolumner med en rad olika alternativ och intelligenta standardvärden.

<?php
$stmt = $dbh->prepare('SELECT name, colour, calories FROM fruit');
$stmt->execute();

/* Binda efter kolumnnummer */
$stmt->bindColumn(1, $name);
$stmt->bindColumn(2, $colour);

/* Binda efter kolumnnamn */
$stmt->bindColumn('calories', $cals);

while ($stmt->fetch(PDO::FETCH_BOUND)) {
    print $name . "\t" . $colour . "\t" . $cals . "\n";
}
?>

Ett möjligt resultat kan se ut så här:

apple   red     150
banana  yellow  175
kiwi    green   75
orange  orange  150
mango   red     200
strawberry      red     25

Se även

• PDOStatement::execute - Exekverar ett förberett uttalande
• PDOStatement::fetch - Hämtar nästa rad från en resultatuppsättning
• PDOStatement::fetchAll - Hämtar de återstående raderna från en resultatuppsättning
• PDOStatement::fetchColumn - Returnerar en enda kolumn från nästa rad i en resultatuppsättning

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/pdostatement.bindcolumn.php
PHP Funktioner Funktionsreferens Databas-tillägg

---

Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp Huddinge som har sponsrat Linux.se med webbhotell.