This is basically a wrapper for mysql_stmt_attr_set in the MySQL C API: http://dev.mysql.com/doc/refman/5.0/en/mysql-stmt-attr-set.html
(PHP 5, PHP 7, PHP 8)
mysqli_stmt::attr_set -- mysqli_stmt_attr_set — Usado para modificar o comportamento de uma instrução preparada
Estilo orientado a objetos
Estilo procedural
Usada para modificar o comportamento de uma instrução preparada. Esta função pode ser chamada múltiplas vezes para definir vários atributos.
statement
Somente no estilo procedural: Um objeto mysqli_stmt retornado por mysqli_stmt_init().
attribute
O atributo que se deseja definir. Pode ser um dos seguintes valores:
Caractere | Descrição |
---|---|
MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH |
Definir para true faz com que mysqli_stmt_store_result() atualize
o valor do metadado MYSQL_FIELD->max_length .
|
MYSQLI_STMT_ATTR_CURSOR_TYPE |
Tipo de cursor a ser aberto para a instrução quando mysqli_stmt_execute()
for chamada. value pode ser MYSQLI_CURSOR_TYPE_NO_CURSOR
(o padrão) ou MYSQLI_CURSOR_TYPE_READ_ONLY .
|
MYSQLI_STMT_ATTR_PREFETCH_ROWS |
Número de linhas a receber do servidor de cada vez ao usar um cursor.
value pode estar na faixa de 1 até o máximo
valor de um inteiro longo sem sinal. O padrão é 1.
|
Se a opção MYSQLI_STMT_ATTR_CURSOR_TYPE
for usada com
MYSQLI_CURSOR_TYPE_READ_ONLY
, um cursor é aberto para a
instrução quando mysqli_stmt_execute() é chamada. Se já houver
um cursor aberto de uma chamada anterior de mysqli_stmt_execute(),
o cursor é fechado antes que um novo seja aberto. mysqli_stmt_reset()
também fecha qualquer cursor aberto antes de preparar a instrução para re-execução.
mysqli_stmt_free_result() fecha qualquer cursor aberto.
Se for aberto um cursor para uma instrução preparada, a função mysqli_stmt_store_result() é desnecessária.
value
O valor a designar para o atributo.
Retorna true
em caso de sucesso ou false
em caso de falha.
Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR
) e a operação solicitada falhar,
um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT
,
uma exceção mysqli_sql_exception será lançada em vez do aviso.
This is basically a wrapper for mysql_stmt_attr_set in the MySQL C API: http://dev.mysql.com/doc/refman/5.0/en/mysql-stmt-attr-set.html