PDOStatement::fetchColumn

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

    PDOStatement::fetchColumn — Sonuç kümesindeki sonraki satırdan tek bir sütun döndürür

    Açıklama

    publicPDOStatement::fetchColumn(int$sütun = 0): mixed

    Sonuç kümesindeki sonraki satırdan tek bir sütun döndürür; artık satır kalmamışsa false döner.

    Bilginize:

    PDOStatement::fetchColumn() mantıksal sütunların alımında kullanılmamalıdır, çünkü sütundaki bir false değerini alınacak satır kalmadığında dönen false değerinden ayırmak imkansızdır. Böyle bir durumda PDOStatement::fetch() kullanılmalıdır.

    Bağımsız Değişkenler

    sütunnum

    Sütunun numarası. İlk sütunun indisi 0'dır. Bağımsız değişkende hiçbir değer belirtilmemişse ilk sütunun değeri döner.

    Dönen Değerler

    Sonuç kümesinde sonraki satırdan tek bir sütunun değerini bir dizge olarak döndürür. Satırlar tükenince false döner.

    Uyarı

    Veriyi almak için PDOStatement::fetchColumn() yöntemini kullanırsanız aynı satırdan artık başka bir sütun döndüremezsiniz.

    Hatalar/İstisnalar

    PDO::ATTR_ERRMODE özniteliğine PDO::ERRMODE_WARNING atanırsa E_WARNING düzeyinde bir hata çıktılanır.

    PDO::ATTR_ERRMODE özniteliğine PDO::ERRMODE_EXCEPTION atanırsa PDOException istisnası oluşur.

    Örnekler

    Örnek 1 - Sonraki satırın ilk sütununu döndürmek

    <?php
    $sth     = $dbh->prepare("SELECT isim, renk FROM meyveler");
    $sth->execute();

    print     "Sonuç kümesindeki sonraki satırın ilk sütunu:\n";
    $result = $sth->fetchColumn();
    print     "name = $result\n";

    print     "Sonuç kümesindeki sonraki satırın ikinci sütunu:\n";
    $result = $sth->fetchColumn(1);
    print     "colour = $result\n";
    ?>

    Yukarıdaki örneğin çıktısı:

    Sonuç kümesindeki sonraki satırın ilk sütunu: isim = limon Sonuç kümesindeki sonraki satırın ikinci sütunu: renk = kırmızı

    Ayrıca Bakınız

    To Top