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

# 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

function 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 aplicaçã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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open