dbExec

Executa um comando SQL do qual você não precisa das linhas de volta.

Sintaxe

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

Parâmetros

Nome	Tipo	Padrão	Descrição
aConexao	db-connection	—	Elemento devolvido por dbConnect.
sql	string	—	Comando a executar.
...	any	—	Valores para os ? da consulta.

Retorno

true assim que o comando é entregue ao processo em segundo plano, false se o primeiro argumento não for um elemento de conexão utilizável.

Nota

true quer dizer aceito, não concluído. O comando roda um instante depois, e se o banco recusar ele, o erro aparece no console de debug — não sobra retorno nenhum para te avisar. Quando você precisa saber se deu certo, ou quer o id da linha que acabou de inserir, use dbQuery e leia o resultado com dbPoll.

dbExec(conexao, "INSERT INTO contas (nome, dinheiro) VALUES (?, ?)", "Gabriel", 5000)
dbExec(conexao, "UPDATE contas SET dinheiro = dinheiro + ? WHERE nome = ?", 250, "Gabriel")

Nota

Se você mandar vários comandos de uma vez, separados por ;, os valores dos ? são aplicados apenas ao primeiro comando. Para passar valores em cada um, chame dbExec uma vez por comando. No MySQL, mandar mais de um comando na mesma chamada exige ainda multi_statements=1 nas opções da conexão.

Veja também

• dbConnect — Abre uma conexão com um banco de dados.
• 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.
• dbPrepareString — Monta uma string SQL com os valores já escapados no lugar dos ?.