DB_SelectNextRow
descrição
A função avança para a próxima linha do conjunto de resultados obtido com DB_ExecuteQuery.
Nome | Descrição |
---|---|
DBResult:dbresult | O resultado retornado por DB_ExecuteQuery. |
retorno
Retorna true se o handle do resultado for válido e ainda não estiver na última linha, caso contrário, retorna false.
exemplo
// examples.inc
Examples_ListNames(DB:dbConnectionHandle)
{
new DBResult:db_result_set = DB_ExecuteQuery("SELECT `name` FROM `examples`");
if (db_result_set)
{
new result[256];
do
{
DB_GetFieldStringByName(db_result_set, "name", result, sizeof result);
}
while (DB_SelectNextRow(db_result_set));
DB_FreeResultSet(db_result_set);
}
}
// mode.pwn
#include <examples>
static DB:gDBConnectionHandle;
public OnGameModeInit()
{
gDBConnectionHandle = DB_Open("example.db");
if (gDBConnectionHandle)
{
print("Conexão à base de dados \"example.db\" criada com sucesso.");
Examples_ListNames(gDBConnectionHandle);
}
else
{
print("Falha ao abrir a base de dados \"example.db\".");
}
return 1;
}
public OnGameModeExit()
{
if (DB_Close(gDBConnectionHandle))
{
gDBConnectionHandle = DB:0;
}
return 1;
}
notas
funções relacionadas
- DB_Open: Abrir conexão com uma base de dados SQLite
- DB_Close: Fechar a conexão com uma base de dados SQLite
- DB_ExecuteQuery: Executar uma consulta SQL
- DB_FreeResultSet: Libertar memória do resultado
- DB_GetRowCount: Obter número de linhas do resultado
- DB_GetFieldCount: Obter número de campos do resultado
- DB_GetFieldName: Obter nome do campo pelo índice
- DB_GetFieldString: Obter conteúdo de campo por índice
- DB_GetFieldStringByName: Obter conteúdo de campo por nome
- DB_GetFieldInt: Obter conteúdo inteiro por índice
- DB_GetFieldIntByName: Obter conteúdo inteiro por nome
- DB_GetFieldFloat: Obter conteúdo float por índice
- DB_GetFieldFloatByName: Obter conteúdo float por nome
- DB_GetMemHandle: Obter handle de memória da base de dados
- DB_GetLegacyDBResult: Obter handle de memória do resultado
- DB_GetDatabaseConnectionCount: Obter número de conexões abertas (debug)
- DB_GetDatabaseResultSetCount: Obter número de resultados abertos (debug)