db2_num_rows

(PECL ibm_db2 >= 1.0.0)

db2_num_rows Retorna o número de linhas afetadas por uma instrução SQL

Descrição

db2_num_rows(resource $stmt): int|false

Retorna o número de linhas excluídas, inseridas ou atualizadas por uma instrução SQL.

Para determinar o número de linhas que serão retornadas por uma instrução SELECT, emita SELECT COUNT(*) com os mesmos predicados que a instrução SELECT pretendida e recupere o valor.

Se a lógica da aplicação verifica o número de linhas retornadas por uma instrução SELECT e ramifica se o número de linhas for 0, considere modificar a aplicação para tentar retornar a primeira linha com uma das funções db2_fetch_assoc(), db2_fetch_both(), db2_fetch_array() ou db2_fetch_row(), e ramificar se a função retornar false.

Nota:

Se for emitida uma instrução SELECT usando um cursor rolável, db2_num_rows() retornará o número de linhas retornadas pela instrução SELECT. No entanto, a sobrecarga associada a cursores roláveis degrada significativamente o desempenho da aplicação. Portanto, se esta for a única razão pela qual estão sendo usados cursores roláveis, deve-se usar um cursor somente de avanço e chamar SELECT COUNT(*) ou confiar no valor de retorno bool das funções de busca para obter a funcionalidade equivalente com desempenho muito melhor.

Parâmetros

stmt

Um recurso stmt válido contendo um conjunto de resultados.

Valor Retornado

Retorna o número de linhas afetadas pela última instrução SQL emitida pelo identificador de instrução especificado, ou false em caso de falha