|
1 | 1 | <?xml version="1.0" encoding="utf-8"?> |
2 | | -<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: leonardolara Status: ready --> |
| 2 | +<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: leonardolara Status: ready --> |
3 | 3 | <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-bind-param"> |
4 | 4 | <refnamediv> |
5 | 5 | <refname>db2_bind_param</refname> |
|
20 | 20 | <methodparam choice="opt"><type>int</type><parameter>scale</parameter><initializer>0</initializer></methodparam> |
21 | 21 | </methodsynopsis> |
22 | 22 |
|
23 | | - <para> |
| 23 | + <simpara> |
24 | 24 | Vincula uma variável PHP a um parâmetro de instrução SQL em um recurso de instrução |
25 | 25 | retornado por <function>db2_prepare</function>. Esta função fornece mais |
26 | 26 | controle sobre o tipo de parâmetro, tipo de dados, precisão e escala para o |
27 | 27 | parâmetro do que simplesmente passar a variável como parte do array de entrada |
28 | 28 | opcional para <function>db2_execute</function>. |
29 | | - </para> |
| 29 | + </simpara> |
30 | 30 |
|
31 | 31 | </refsect1> |
32 | 32 | <refsect1 role="parameters"> |
|
35 | 35 | <varlistentry> |
36 | 36 | <term><parameter>stmt</parameter></term> |
37 | 37 | <listitem> |
38 | | - <para> |
| 38 | + <simpara> |
39 | 39 | Uma instrução preparada retornada de <function>db2_prepare</function>. |
40 | | - </para> |
| 40 | + </simpara> |
41 | 41 | </listitem> |
42 | 42 | </varlistentry> |
43 | 43 | <varlistentry> |
44 | 44 | <term><parameter>parameter_number</parameter></term> |
45 | 45 | <listitem> |
46 | | - <para> |
| 46 | + <simpara> |
47 | 47 | Especifica a posição, indexada a partir de 1, do parâmetro na instrução |
48 | 48 | preparada. |
49 | | - </para> |
| 49 | + </simpara> |
50 | 50 | </listitem> |
51 | 51 | </varlistentry> |
52 | 52 | <varlistentry> |
53 | 53 | <term><parameter>variable_name</parameter></term> |
54 | 54 | <listitem> |
55 | | - <para> |
| 55 | + <simpara> |
56 | 56 | Uma string especificando o nome da variável PHP a ser vinculada ao |
57 | 57 | parâmetro especificado por <parameter>parameter_number</parameter>. |
58 | | - </para> |
| 58 | + </simpara> |
59 | 59 | </listitem> |
60 | 60 | </varlistentry> |
61 | 61 | <varlistentry> |
62 | 62 | <term><parameter>parameter_type</parameter></term> |
63 | 63 | <listitem> |
64 | | - <para> |
| 64 | + <simpara> |
65 | 65 | Uma constante especificando se a variável PHP deve ser vinculada ao |
66 | 66 | parâmetro SQL como um parâmetro de entrada (<constant>DB2_PARAM_IN</constant>), |
67 | 67 | um parâmetro de saída (<constant>DB2_PARAM_OUT</constant>) ou como um |
|
70 | 70 | também especificar <constant>DB2_PARAM_FILE</constant> para vincular a variável PHP |
71 | 71 | ao nome de um arquivo que contém dados de objeto grande (BLOB, CLOB ou |
72 | 72 | DBCLOB). |
73 | | - </para> |
| 73 | + </simpara> |
74 | 74 | </listitem> |
75 | 75 | </varlistentry> |
76 | 76 | <varlistentry> |
77 | 77 | <term><parameter>data_type</parameter></term> |
78 | 78 | <listitem> |
79 | | - <para> |
| 79 | + <simpara> |
80 | 80 | Uma constante especificando o tipo de dados SQL como o qual a variável PHP deverá |
81 | 81 | ser vinculada: uma das constantes <constant>DB2_BINARY</constant>, |
82 | 82 | <constant>DB2_CHAR</constant>, <literal>DB2_DOUBLE</literal> ou |
83 | 83 | <constant>DB2_LONG</constant>. |
84 | | - </para> |
| 84 | + </simpara> |
85 | 85 | </listitem> |
86 | 86 | </varlistentry> |
87 | 87 | <varlistentry> |
88 | 88 | <term><parameter>precision</parameter></term> |
89 | 89 | <listitem> |
90 | | - <para> |
| 90 | + <simpara> |
91 | 91 | Especifica a precisão com a qual a variável deve ser vinculada ao |
92 | 92 | banco de dados. Este parâmetro também pode ser usado para recuperar valores de saída XML |
93 | 93 | de procedimentos armazenados. Um valor não negativo especifica o tamanho máximo |
94 | 94 | dos dados XML que serão recuperados do banco de dados. Se este parâmetro |
95 | 95 | não for usado, um padrão de 1 MB será assumido para recuperar o valor de saída XML |
96 | 96 | do procedimento armazenado. |
97 | | - </para> |
| 97 | + </simpara> |
98 | 98 | </listitem> |
99 | 99 | </varlistentry> |
100 | 100 | <varlistentry> |
101 | 101 | <term><parameter>scale</parameter></term> |
102 | 102 | <listitem> |
103 | | - <para> |
| 103 | + <simpara> |
104 | 104 | Especifica a escala com a qual a variável deve ser vinculada ao |
105 | 105 | banco de dados. |
106 | | - </para> |
| 106 | + </simpara> |
107 | 107 | </listitem> |
108 | 108 | </varlistentry> |
109 | 109 | </variablelist> |
110 | 110 | </refsect1> |
111 | 111 | <refsect1 role="returnvalues"> |
112 | 112 | &reftitle.returnvalues; |
113 | | - <para> |
| 113 | + <simpara> |
114 | 114 | &return.success; |
115 | | - </para> |
| 115 | + </simpara> |
116 | 116 | </refsect1> |
117 | 117 |
|
118 | 118 | <refsect1 role="examples"> |
119 | 119 | &reftitle.examples; |
120 | 120 | <para> |
121 | 121 | <example> |
122 | 122 | <title>Vinculando variáveis PHP a uma instrução preparada</title> |
123 | | - <para> |
| 123 | + <simpara> |
124 | 124 | A instrução SQL no exemplo a seguir usa dois parâmetros de entrada na |
125 | 125 | cláusula WHERE. Chamamos <function>db2_bind_param</function> para vincular duas |
126 | 126 | variáveis PHP aos parâmetros SQL correspondentes. Observe que as variáveis PHP |
|
132 | 132 | <function>db2_bind_param</function>. As variáveis devem ser vinculadas e, para |
133 | 133 | parâmetros que aceitam entrada, devem ter qualquer valor atribuído, antes de chamar |
134 | 134 | <function>db2_execute</function>. |
135 | | - </para> |
| 135 | + </simpara> |
136 | 136 | <programlisting role="php"> |
137 | 137 | <![CDATA[ |
138 | 138 | <?php |
@@ -175,23 +175,23 @@ Peaches, dog, 12.3 |
175 | 175 | três parâmetros diferentes: |
176 | 176 | <orderedlist> |
177 | 177 | <listitem> |
178 | | - <para> |
| 178 | + <simpara> |
179 | 179 | um parâmetro de entrada (IN) que aceita o nome do primeiro animal como |
180 | 180 | entrada |
181 | | - </para> |
| 181 | + </simpara> |
182 | 182 | </listitem> |
183 | 183 | <listitem> |
184 | | - <para> |
| 184 | + <simpara> |
185 | 185 | um parâmetro de entrada-saída (INOUT) que aceita o nome do segundo |
186 | 186 | animal como entrada e retorna a string <literal>TRUE</literal> se um |
187 | 187 | animal no banco de dados corresponder a ele |
188 | | - </para> |
| 188 | + </simpara> |
189 | 189 | </listitem> |
190 | 190 | <listitem> |
191 | | - <para> |
| 191 | + <simpara> |
192 | 192 | um parâmetro de saída (OUT) que retorna a soma do peso dos |
193 | 193 | dois animais identificados |
194 | | - </para> |
| 194 | + </simpara> |
195 | 195 | </listitem> |
196 | 196 | </orderedlist> |
197 | 197 | Além disso, o procedimento armazenado retorna um conjunto de resultados consistindo de |
@@ -248,14 +248,14 @@ Resultados: |
248 | 248 | </example> |
249 | 249 | <example> |
250 | 250 | <title>Inserindo um objeto binário grande (BLOB) diretamente de um arquivo</title> |
251 | | - <para> |
| 251 | + <simpara> |
252 | 252 | Os dados para objetos grandes são normalmente armazenados em arquivos, como documentos XML |
253 | 253 | ou arquivos de áudio. Em vez de ler um arquivo inteiro em uma variável PHP |
254 | 254 | e, em seguida, vincular essa variável PHP a uma instrução SQL, é |
255 | 255 | possível evitar sobrecarga de memória vinculando o arquivo diretamente ao parâmetro de entrada |
256 | 256 | da instrução SQL. O exemplo a seguir demonstra como |
257 | 257 | vincular um arquivo diretamente a uma coluna BLOB. |
258 | | - </para> |
| 258 | + </simpara> |
259 | 259 | <programlisting role="php"> |
260 | 260 | <![CDATA[ |
261 | 261 | <?php |
|
0 commit comments