db2_num_fields

(PECL ibm_db2 >= 1.0.0)

db2_num_fields — Retorna o número de campos contidos em um conjunto de resultados

Descrição

db2_num_fields(resource $stmt): int|false

Retorna o número de campos contidos em um conjunto de resultados. Isso é mais útil para lidar com os conjuntos de resultados retornados por consultas geradas dinamicamente, ou para conjuntos de resultados retornados por procedimentos armazenados, onde a aolicação não pode de outra forma saber como recuperar e usar os resultados.

Parâmetros

stmt: Um recurso de instrução válido contendo um conjunto de resultados.

Valor Retornado

Retorna um valor inteiro representando o número de campos no conjunto de resultados associado ao recurso de instrução especificado. Retorna false se o recurso de instrução não for um valor de entrada válido.

Exemplos

Exemplo #1 Recuperando o número de campos em um conjunto de resultados

O exemplo a seguir demonstra como recuperar o número de campos retornados em um conjunto de resultados.

<?php

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

echo "Há {$columns} colunas no conjunto de resultados.";
?>

O exemplo acima produzirá:

Há 4 colunas no conjunto de resultados.

Veja Também

db2_execute() - Executa uma instrução SQL preparada
db2_field_display_size() - Retorna o número máximo de bytes necessários para exibir uma coluna
db2_field_name() - Retorna o nome da coluna no conjunto de resultados
db2_field_num() - Retorna a posição da coluna nomeada em um conjunto de resultados
db2_field_precision() - Retorna a precisão da coluna indicada em um conjunto de resultados
db2_field_scale() - Retorna a escala da coluna indicada em um conjunto de resultados
db2_field_type() - Retorna o tipo de dados da coluna indicada em um conjunto de resultados
db2_field_width() - Retorna a largura do valor atual da coluna indicada em um conjunto de resultados