db2_fetch_both

    (PECL ibm_db2 >= 1.0.0)

    db2_fetch_both — Возвращает массив, индексированный как по имени столбца, так и по позиции, представляющий строку в наборе результатов

    Описание

    db2_fetch_both(resource $stmt, int $row_number = -1): array|false

    Возвращает массив, индексированный как по имени столбца, так и по позиции, представляющий строку в наборе результатов. Обратите внимание, что строка, возвращаемая db2_fetch_both(), требует больше памяти, чем массивы с одним индексом, возвращаемые db2_fetch_assoc() или db2_fetch_array().

    Список параметров

    stmt

    Допустимый ресурс stmt, содержащий набор результатов.

    row_number

    Запрашивает конкретную строку по индексу (начинается с 1) из набора результатов. Передача параметра приводит к предупреждению PHP, если в наборе результатов используется курсор "forward-only".

    Возвращаемые значения

    Возвращает ассоциативный массив со значениями столбцов, проиндексированными как по имени столбца, так и по индексу столбца (начиная с 0). Массив представляет следующую или запрошенную строку в наборе результатов. Возвращает false, если в наборе результатов не осталось строк или если строка, запрошенная row_number, не существует в наборе результатов.

    Примеры

    Пример #1 Перебор курсором "forward-only"

    Если вы вызываете db2_fetch_both() без определённого номера строки, он автоматически получает следующую строку в наборе результатов. В следующем примере доступ к столбцам в возвращаемом массиве осуществляется как по имени столбца, так и по числовому индексу.

    <?php

    $sql     = "SELECT id, name, breed, weight FROM animals ORDER BY breed";
    $stmt = db2_prepare($conn, $sql);
    $result = db2_execute($stmt);

    while (    $row = db2_fetch_both($stmt)) {
    printf ("%-5d %-16s %-32s %10s\n",
    $row['ID'], $row[0], $row['BREED'], $row[3]);
    }
    ?>

    Результат выполнения приведённого примера: 

    0     Pook             cat                                    3.20
5     Rickety Ride     goat                                   9.70
2     Smarty           horse                                350.00

    Пример #2 Получение определённых строк с помощью db2_fetch_both() из прокручиваемого курсора

    Если в вашем наборе результатов используется прокручиваемый курсор, вы можете вызвать db2_fetch_both() с определённым номером строки. В следующем примере извлекается каждая вторая строка в наборе результатов, начиная со второй строки.

    <?php

    $sql     = "SELECT id, name, breed, weight FROM animals ORDER BY breed";
    $result = db2_exec($stmt, $sql, array('cursor' => DB2_SCROLLABLE));

    $i=2;
    while (    $row = db2_fetch_both($result, $i)) {
    printf ("%-5d %-16s %-32s %10s\n",
    $row[0], $row['NAME'], $row[2], $row['WEIGHT']);
    $i = $i + 2;
    }
    ?>

    Результат выполнения приведённого примера: 

    0     Pook             cat                                    3.20
5     Rickety Ride     goat                                   9.70
2     Smarty           horse                                350.00

    Смотрите также

    • db2_fetch_array() - Возвращает массив, индексированный по положению столбца, представляющий строку в наборе результатов
    • db2_fetch_assoc() - Возвращает массив, индексированный по имени столбца, представляющий строку в наборе результатов
    • db2_fetch_object() - Возвращает объект со свойствами, представляющими столбцы в выбранной строке
    • db2_fetch_row() - Устанавливает указатель набора результатов на следующую строку или запрошенную строку
    • db2_result() - Возвращает один столбец из строки в наборе результатов

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 1 note

    up
    0
    eacosta at openware dot biz
    16 years ago
    Hello,

    Some weeks ago I faced difficulties with walk a big number of
    records from a result set.

    I was using the function db2_fetch_both in a method of a database adapter
    class to retrieve just one record at a time. The total number of records
    were: 5647 and when I reach record number 1600 the function crashed
    generating the below message in "Actual result" field.

    I am copying table's description next:

    TMP_TABLE
    -----------------------------------------------------------------
    | ID | TYPE | SIZE | NULL |
    -----------------------------------------------------------------
    | ID | INTEGER | 4 | NO |
    | SERVICE | VARCHAR | 30 | NO |
    | ID_v | VARCHAR | 30 | NO |
    | INFORMATION | CLOB | 65536 | YES |
    | EXP_LEVEL | INTEGER | 4 | NO |
    | IP4B | BIGINT | 8 | NO |
    | MODIFIED | INTEGER | 4 | YES |
    | DETAIL | VARCHAR | 200 | YES |
    | FALSPOS | INTEGER | 4 | YES |
    -----------------------------------------------------------------

    When it crashed I received this message from db2_fetch_both

    db2_fetch_array() [function.db2-fetch-array]: Fetch Failure

    After reported this message to IBM OpenDev I was helped by a OpenDev IBMer who noticed me
    that it wasn't a ibm_db2 module problem, in fact it was a database configuration
    issue. The OpenDev IBMer looked into my DB2 Client CLI TRACE files and found out what was happen.
    So I had to modify APP_CTL_HEAP_SZ and everything seems to works fine now.

    --
    Esteban Acosta Villafañe
    Area I+D
    http://www.openware.biz/opendev
    Linkein Profile: http://www.linkedin.com/in/estebanav
    ＋Добавить
    To Top