array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pg-field-prtlen.php', 1 => 'pg_field_prtlen', 2 => 'Retorna o comprimento impresso', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funções PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-field-num.php', 1 => 'pg_field_num', ), 'next' => array ( 0 => 'function.pg-field-size.php', 1 => 'pg_field_size', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pgsql/functions/pg-field-prtlen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_field_prtlen

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

pg_field_prtlen — Retorna o comprimento impresso

Descrição

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() retorna o comprimento real impresso (número de caracteres) de um valor específico em um result do PostgreSQL. A numeração das linhas começa em 0. Esta função retornará false em caso de erro.

field_name_or_number pode ser passado como um int ou como uma string. Se for passado como int, o PHP o reconhece como o número do campo, caso contrário, como o nome do campo.

Veja o exemplo dado na página pg_field_name().

Nota:

Esta função costumava ser chamada de pg_fieldprtlen().

Parâmetros

result

Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).

row

Número da linha no resultado. As linhas são numeradas de 0 para cima. Se omitido, a linha atual será buscada.

Valor Retornado

O comprimento impresso do campo.

Registro de Alterações

Versão Descrição
8.3.0 row agora é anulável.
8.1.0 O parâmetro result agora espera uma instância de PgSql\Result; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Obtendo informações sobre campos

<?php
$dbconn = pg_connect("dbname=publisher") or die(" connect");

$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";
}
?>

O exemplo acima produzirá:

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

Veja Também