array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.cubrid-prepare.php', 1 => 'cubrid_prepare', 2 => 'Prepara uma instrução SQL para execução', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Funções de CUBRID', ), 'prev' => array ( 0 => 'function.cubrid-pconnect-with-url.php', 1 => 'cubrid_pconnect_with_url', ), 'next' => array ( 0 => 'function.cubrid-put.php', 1 => 'cubrid_put', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/cubrid/functions/cubrid-prepare.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

cubrid_prepare

(PECL CUBRID >= 8.3.0)

cubrid_prepare — Prepara uma instrução SQL para execução

Descrição

cubrid_prepare(resource $conn_identifier, string $prepare_stmt, int $option = 0): resource

A função cubrid_prepare() é um tipo de API que representa instruções SQL compiladas previamente para um determinado identificador de conexão. Esta instrução SQL pré-compilada será incluída em cubrid_prepare().

Consequentemente, pode-se usar esta instrução de forma eficaz para executar várias vezes repetidamente ou para processar dados massivos. Apenas uma única instrução pode ser usada e um parâmetro pode ser colocado como um ponto de interrogação (?) na área apropriada da instrução SQL. Adicione um parâmetro ao vincular um valor na cláusula VALUES da instrução INSERT ou na cláusula WHERE. Observe que é permitido vincular um valor a uma marca (?) usando apenas a função cubrid_bind().

Parâmetros

conn_identifier
Identificador da conexão.
prepare_stmt
Instrução de preparação.
option
Opção de retorno de OID: CUBRID_INCLUDE_OID.

Valor Retornado

Identificador da requisição em caso de sucesso, ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de cubrid_prepare()

<?php
$conn = cubrid_connect("localhost", 33000, "demodb");

$sql = <<<EOD
SELECT g.event_code, e.name
FROM game g
JOIN event e ON g.event_code=e.code
WHERE host_year = ? AND event_code NOT IN (SELECT event_code FROM game WHERE host_year=?) GROUP BY event_code;
EOD;

$req = cubrid_prepare($conn, $sql);

cubrid_bind($req, 1, 2004);
cubrid_bind($req, 2, 2000);
cubrid_execute($req);

$row_num = cubrid_num_rows($req);
printf("Existem %d eventos que ocorrem nas Olimpíadas de 2004 mas não ocorrem em 2000. Por exemplo:\n\n", $row_num);

printf("%-15s %s\n", "Cód. do evento", "Nome do evento");
printf("------------------------------\n");

$row = cubrid_fetch_assoc($req);
printf("%-15d %s\n", $row["event_code"], $row["name"]);
$row = cubrid_fetch_assoc($req);
printf("%-15d %s\n", $row["event_code"], $row["name"]);

cubrid_disconnect($conn);
?>

O exemplo acima produzirá:

Existem 27 eventos que ocorrem nas Olimpíadas de 2004 mas não ocorrem em 2000. Por exemplo:

Cód. do evento  Nome do evento
------------------------------
20063           +91kg
20070           64kg

Veja Também