pg_field_prtlen

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    pg_field_prtlen — Возвращает количество печатаемых символов

    Описание

    pg_field_prtlen(PgSql\Result$result, string|false|null$row, mixed$field_name_or_number): int
    pg_field_prtlen(PgSql\Result$result, mixed$field_name_or_number): int

    Функция pg_field_prtlen() возвращает длину строки, количество символов, значения поля при выводе результата result. Строки нумеруются с нуля. Функция вернёт false в случае возникновения ошибки.

    field_name_or_number Номер или имя выбранного поля. Может передаваться либо как int, либо как string. Если передаётся значение типа int, PHP распознает его как номер, в противном случае как наименование поля.

    Ознакомьтесь с примерами на странице с описанием функции pg_field_name().

    Замечание:

    Прежнее название функции: pg_fieldprtlen().

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

    result

    Экземпляр класса PgSql\Result, который возвращают функции pg_query(), pg_query_params() или pg_execute() (среди прочего).

    row

    Номер строки в результате. Нумерация строк начинается с нуля. Функция выбирает текущую строку, если аргумент не задан.

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

    Функция возвращает длину строки при выводе значения поля.

    Список изменений

    ВерсияОписание
    8.3.0 Параметр row теперь принимает значение null.
    8.1.0 Параметр result теперь ожидает экземпляр класса PgSql\Result; раньше параметр ждал ресурс (resource).

    Примеры

    Пример #1 Получение информации о полях выборки

    <?php

    $dbconn     = pg_connect("dbname=publisher") or die("Не удалось соединиться с базой");
    $res = pg_query($dbconn, "SELECT * FROM authors WHERE author = 'Orwell'");

    $i = pg_num_fields($res);
    for (    $j = 0; $j < $i; $j++) {
    echo     "column $j\n";
    $fieldname = pg_field_name($res, $j);
    echo     "fieldname: $fieldname\n";
    echo     "printed length: " . pg_field_prtlen($res, $fieldname) . " characters\n";
    echo     "storage length: " . pg_field_size($res, $j) . " bytes\n";
    echo     "field type: " . pg_field_type($res, $j) . " \n\n";
    }

    ?>

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

    column 0 fieldname: author printed length: 6 characters storage length: -1 bytes field type: varchar column 1 fieldname: year printed length: 4 characters storage length: 2 bytes field type: int2 column 2 fieldname: title printed length: 24 characters storage length: -1 bytes field type: varchar

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

    To Top