PHP 8.4.24 Released!

pg_field_prtlen

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

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

Описание

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

Функция pg_field_prtlen() возвращает количество символов, которое займет при выводе значение поля из объекта result с результатами запроса к СУБД PostgreSQL. Строки нумеруются с нуля. Функция вернёт 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.4.0 Сигнатура функции pg_field_prtlen() с двумя аргументами — result и field — устарела; функцию вызывают с тремя аргументами с передачей в параметр row значения null.
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 "Столбец $j\n";
    $fieldname = pg_field_name($res, $j);
    echo "Название поля: $fieldname\n";
    echo "Количество: " . pg_field_prtlen($res, $fieldname) . " символов\n";
    echo "Размер в хранилище в байтах: " . pg_field_size($res, $j) . "\n";
    echo "Тип поля: " . pg_field_type($res, $j) . " \n\n";
}

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

Столбец 0
Название поля: author
Количество: 6 символов
Размер в хранилище в байтах: -1
Тип поля: varchar

Столбец 1
Название поля: year
Количество: 4 символов
Размер в хранилище в байтах: 2
Тип поля: int2

Столбец 2
Название поля: title
Количество: 24 символов
Размер в хранилище в байтах: -1
Тип поля: varchar

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

Добавить

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

up
1
gregm at gxsnmp dot org
19 years ago
If you update the query to this:

$s = "SELECT a.attname AS name, t.typname AS type, a.attlen AS size, a.atttypmod AS len, a.attstorage AS i
   FROM pg_attribute a , pg_class c, pg_type t
   WHERE c.relname = '$TABLE'
   AND a.attrelid = c.oid AND a.atttypid = t.oid and a.attnum > 0 and not a.attisdropped";

You get postgres to filter out the 'postgres' columns and get only your columns back.
up
0
djmaze@moocms
18 years ago
Or even easier to keep things simple on fetching

SELECT a.attname AS name, t.typname AS type, a.attstorage AS i,
    CASE WHEN a.attlen = -1 THEN a.atttypmod ELSE a.attlen END AS size
    FROM pg_attribute a , pg_class c, pg_type t
    WHERE c.relname = 'moo_members'
    AND a.attrelid = c.oid AND a.atttypid = t.oid and a.attnum > 0 and not a.attisdropped
up
0
r dot galovic at r-3 dot at
21 years ago
mysql_field_len () function and more for postgres ...

problems ...
* pg_field_prtlen ... gives the actual size of the field back (it shows the count of the content allready inside the field - not the possible max-len)
* pg_filed_size ... can't be used for varchar or bpchar fields 

...but there is a way to get the real-max-length of a field in postgreSQL via the system tables:

//returns an array with infos of every field in the table (name, type, length, size)
function SQLConstructFieldsInfo($TABLE, $DBCON)
{
    $s="SELECT a.attname AS name, t.typname AS type, a.attlen AS size, a.atttypmod AS len, a.attstorage AS i 
    FROM pg_attribute a , pg_class c, pg_type t 
    WHERE c.relname = '$TABLE'  
    AND a.attrelid = c.oid AND a.atttypid = t.oid";
    
    if ($r = pg_query($DBCON,$s))
    {
        $i=0;
        while ($q = pg_fetch_assoc($r))
        {
               $a[$i]["type"]=$q["type"];
               $a[$i]["name"]=$q["name"];
               if($q["len"]<0 && $q["i"]!="x")
               {
                   // in case of digits if needed ... (+1 for negative values)
                   $a[$i]["len"]=(strlen(pow(2,($q["size"]*8)))+1);
               }
               else
               {
                   $a[$i]["len"]=$q["len"];
               }
               $a[$i]["size"]=$q["size"];
            $i++;            
        }
        return $a;
    }
    return null;
}

// usage
$DBCON=pg_connect("host=YOUR-HOST port=YOUR-PORT dbname=YOUR-DB user=YOUR-USER password=YOUR-PASS");
$TABLE="YOUR-TABLENAME";
$RET=SQLConstructFieldsInfo($TABLE, $DBCON);

$j = count($RET);
for ($i=0; $i < $j; $i++)
{
    echo "<br>$i name=".$RET[$i]["name"]." type=".$RET[$i]["type"]." length=".$RET[$i]["len"]." size=".$RET[$i]["size"]." bytes";
}
To Top