dbPrepareString

Monta uma string SQL com os valores já escapados no lugar dos ?.

Sintaxe

string dbPrepareString ( db-connection aConexao, string sql [, ... ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
aConexao	db-connection	—	Elemento devolvido por dbConnect.
sql	string	—	Consulta com ? no lugar dos valores.
...	any	—	Valores para os ?, na ordem em que aparecem.

Cada valor é convertido conforme o tipo: strings saem entre aspas e com o escape correto, números saem como estão, booleanos viram 1 ou 0 e nil vira NULL. ? dentro de um texto entre aspas simples é deixado como está, e se houver mais ? do que valores os que sobram também ficam intactos. O escape é feito pela conexão que você passa, ou seja, segue as regras daquele banco — é por isso que a conexão é um argumento e não um detalhe.

Retorno

A consulta pronta como string, ou false se o elemento de conexão não estiver utilizável.

local sql = dbPrepareString(conexao, "SELECT * FROM contas WHERE nome = ?", nome)
outputDebugString(sql)

Nota

Prefira passar os valores direto para dbExec e dbQuery. dbPrepareString é útil quando você precisa montar o texto da consulta antes — para registrar em log ou juntar partes dinâmicas — e não quer perder o escape.

Veja também

• dbConnect — Abre uma conexão com um banco de dados.
• dbExec — Executa um comando SQL do qual você não precisa das linhas de volta.
• dbQuery — Dispara uma consulta e devolve um handle para você ler o resultado com dbPoll.
• dbPoll — Recolhe o resultado de uma consulta.
• dbFree — Descarta um resultado que você não vai ler.