- Documentation Library
- Table of Contents
- MySQL 3.23/4.0/4.1 Manual
- Table of Contents
- 12.1.3 Descrição das Funções da API C
- 12.1.3.1 mysql_affected_rows()
- 12.1.3.2 mysql_change_user()
- 12.1.3.3 mysql_character_set_name()
- 12.1.3.4 mysql_close()
- 12.1.3.5 mysql_connect()
- 12.1.3.6 mysql_create_db()
- 12.1.3.7 mysql_data_seek()
- 12.1.3.8 mysql_debug()
- 12.1.3.9 mysql_drop_db()
- 12.1.3.10 mysql_dump_debug_info()
- 12.1.3.11 mysql_eof()
- 12.1.3.12 mysql_errno()
- 12.1.3.13 mysql_error()
- 12.1.3.14 mysql_escape_string()
- 12.1.3.15 mysql_fetch_field()
- 12.1.3.16 mysql_fetch_fields()
- 12.1.3.17 mysql_fetch_field_direct()
- 12.1.3.18 mysql_fetch_lengths()
- 12.1.3.19 mysql_fetch_row()
- 12.1.3.20 mysql_field_count()
- 12.1.3.21 mysql_field_seek()
- 12.1.3.22 mysql_field_tell()
- 12.1.3.23 mysql_free_result()
- 12.1.3.24 mysql_get_client_info()
- 12.1.3.25 mysql_get_client_version()
- 12.1.3.26 mysql_get_host_info()
- 12.1.3.27 mysql_get_proto_info()
- 12.1.3.28 mysql_get_server_info()
- 12.1.3.29 mysql_get_server_version()
- 12.1.3.30 mysql_info()
- 12.1.3.31 mysql_init()
- 12.1.3.32 mysql_insert_id()
- 12.1.3.33 mysql_kill()
- 12.1.3.34 mysql_list_dbs()
- 12.1.3.35 mysql_list_fields()
- 12.1.3.36 mysql_list_processes()
- 12.1.3.37 mysql_list_tables()
- 12.1.3.38 mysql_num_fields()
- 12.1.3.39 mysql_num_rows()
- 12.1.3.40 mysql_options()
- 12.1.3.41 mysql_ping()
- 12.1.3.42 mysql_query()
- 12.1.3.43 mysql_real_connect()
- 12.1.3.44 mysql_real_escape_string()
- 12.1.3.45 mysql_real_query()
- 12.1.3.46 mysql_reload()
- 12.1.3.47 mysql_row_seek()
- 12.1.3.48 mysql_row_tell()
- 12.1.3.49 mysql_select_db()
- 12.1.3.50 mysql_set_server_option()
- 12.1.3.51 mysql_shutdown()
- 12.1.3.52 mysql_sqlstate()
- 12.1.3.53 mysql_ssl_set()
- 12.1.3.54 mysql_stat()
- 12.1.3.55 mysql_store_result()
- 12.1.3.56 mysql_thread_id()
- 12.1.3.57 mysql_use_result()
- 12.1.3.58 mysql_warning_count()
- 12.1.3.59 mysql_commit()
- 12.1.3.60 mysql_rollback()
- 12.1.3.61 mysql_autocommit()
- 12.1.3.62 mysql_more_results()
- 12.1.3.63 mysql_next_result()
MYSQL_RES *mysql_store_result(MYSQL *mysql)
Descrição
Você deve chamar mysql_store_result() ou
mysql_use_result() para cada consulta que
retorne dados com sucesso (SELECT,
SHOW, DESCRIBE,
EXPLAIN).
Você não precisa chamar
mysql_store_result() ou
mysql_use_result() para outras consultas,
mas ele não causará nenhum dano ou nenhuma queda notel de
desempenho se você chamar
mysql_store_result() em todos os casos.
Você pode detectar se a consulta não obteve resultado
verificando se mysql_store_result()
retornou 0.
Se você quiser saber se a consulta devia retornar algum
resultado, você pode utilizar
mysql_field_count() para fazer a
verificação. See Secção 12.1.3.20, “mysql_field_count()”.
mysql_store_result() lê todo o resultado
de uma consulta para um cliente, aloca uma estrutura
MYSQL_RES e coloca o resultado nesta
estrutura.
mysql_store_result() retorna um ponteiro
para null se a consulta não retornar um resultado (se a
consulta foi, por exemplo, uma instrução
INSERT).
mysql_store_result() também retorna um
ponterio para null se a leitura do resultado falhar. Você
pode verficar se você obteve um erro verificando se
mysql_error() não retornou um ponterio
para null, se mysql_errno() retorna
<> 0, ou se mysql_field_count()
retorna <> 0.
Um resultado vazio é retornado se não houver registros a retornar. (Um resultado vazio é diferente de um ponteiro para null em um valor de retorno).
Uma vez que você tenha chamado
mysql_store_result() e tenha retornado um
resultado que não é uma apontador para null, você pode
chamar mysql_num_rows() para descobrir
quantas linhas existem no resultado.
Você pode chamar mysql_fetch_row() para
buscar registros no resultado ou
mysql_row_seek() e
mysql_row_tell() para obter ou definir a
poição atual do registro dentro do resultado.
Você deve chamar mysql_free_result()
quando tiver terminado com o resultado.
Valor Retornado
Uma estrutura de resultado MYSQL_RES com o
resultado. NULL se um erro ocorreu.
Erros
mysql_store_result() zera
mysql_error e
mysql_errno se ela obter sucesso.
-
CR_COMMANDS_OUT_OF_SYNCOs comando foram executados em uma ordem inpropriada.
-
CR_OUT_OF_MEMORYSem memoria.
-
CR_SERVER_GONE_ERRORO servidor MySQL foi finalizado.
-
CR_SERVER_LOSTA conexão ao servidor MySQL foi perdida durante a consulta.
-
CR_UNKNOWN_ERRORUm erro desconhecido ocorreu.
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.
