DB_GetFieldStringByName
Descrição
Obtém o conteúdo de um campo pelo nome especificado.
Nome | Descrição |
---|---|
DBResult:result | Resultado de onde obter os dados. |
const field[] | Nome do campo para obter os dados. |
output[] | Variável para armazenar o resultado. |
size = sizeof(output) | Tamanho máximo do campo. |
Retorno
Retorna true se o handle do resultado for válido e a coluna existir, caso contrário false.
Exemplo
// examples.inc
Examples_ListNames(DB:dbConnectionHandle)
{
new DBResult:db_result_set = DB_ExecuteQuery(dbConnectionHandle, "SELECT `name` FROM `examples`");
if (db_result_set)
{
new result[256];
do
{
DB_GetFieldStringByName(db_result_set, "name", result, sizeof result);
// Pode usar o resultado aqui
}
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 com o banco \"example.db\" criada com sucesso.");
Examples_ListNames(gDBConnectionHandle);
}
else
{
print("Falha ao abrir conexão com o banco \"example.db\".");
}
return 1;
}
public OnGameModeExit()
{
if (DB_Close(gDBConnectionHandle))
{
gDBConnectionHandle = DB:0;
}
return 1;
}
Notas
Funções Relacionadas
- DB_Open: Abre conexão com banco SQLite
- DB_Close: Fecha conexão com banco SQLite
- DB_ExecuteQuery: Executa consulta no banco
- DB_FreeResultSet: Libera memória do resultado
- DB_GetRowCount: Obtém número de linhas do resultado
- DB_SelectNextRow: Avança para próxima linha
- DB_GetFieldCount: Obtém número de campos do resultado
- DB_GetFieldName: Retorna nome do campo pelo índice
- DB_GetFieldString: Obtém conteúdo do campo pelo índice
- DB_GetFieldStringByName: Obtém conteúdo do campo pelo nome
- DB_GetFieldInt: Obtém conteúdo do campo como inteiro pelo índice
- DB_GetFieldIntByName: Obtém conteúdo do campo como inteiro pelo nome
- DB_GetFieldFloat: Obtém conteúdo do campo como float pelo índice
- DB_GetFieldFloatByName: Obtém conteúdo do campo como float pelo nome
- DB_GetMemHandle: Obtém handle de memória do banco aberto com DB_Open
- DB_GetLegacyDBResult: Obtém handle de memória do resultado DB_ExecuteQuery
- DB_GetDatabaseConnectionCount: Número de conexões abertas
- DB_GetDatabaseResultSetCount: Número de resultados abertos