Veja a baixo as funções:
1) tsql_connect - Abre uma conexão
int tsql_connect (pointer id_conexao, cadeia conexão,
cadeia usuário, cadeia password)
conexão : cadeia do tipo “HST=…;DSN=…;UID=…;PWD=….;etc…”
usuário : corresponde à palavra de nível.
password : corresponde ao código de segurança
retorna 0 e uma identificação de conexão
do tipo pointer ou -1 se erro.
Se na conexão, forem atribuidos valores aos itens
UID e PWD(palavra de nível e código de
segurança), esses valores terão prioridade
sobre os valores passados pelos parâmetros (usuário
e password.)
Ex:
pointer con
if tsql_connect(con, “HST=10.1.1.26;DSN=/home/banco/teste“,””,””)
= -1
? “erro na conexao”
quit
endif
2)
tsql_close - Termina uma conexão
int tsql_close (pointer id_conexão)
id_conexão : identificação da conexão
do tipo pointer
retorna 0 se sucesso, -1 se erro.
3)
tsql_query - executa um commando SQL
int tsql_query( pointer id_conexão, cadeia query,
pointer id_resultado)
id_conexão : identificação de uma
conexão aberta
query : texto do commando SQL
retorna 0 e uma identificação de resultado
ou -1 se erro
Ex:
pointer con
pointer res
r=tsql_query(con, “select * from PESSOA”, res)
4)
tsql_num_fields - devolve o número de colunas
de uma linha
int tsql_num_fields ( pointer id_resultado);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query .
retorna número de colunas ou -1 se erro.
Se o número de colunas retornados for igual a
zero, o commando SQL executado, não é
um commando SELECT.
5)
tsql_fetch_row - lê a proxima linha de um conjunto
resultado em uma string com valores separados por
delimitador
int tsql_fetch_row( pointer id_resultado, cadeia campos,
cadeia separador )
id_resultado : identificador de resultado devolvido
por uma chamada sql_query para um commando SQL do tipo
SELECT.
campos : area de retorno da linha
separador: cadeia cujo primeiro caracter é o
separador dos campos
retorna 0 se existe a linha, se não retorna -1
tsql_fetch_row retorna a próxima linha de um
conjunto resultado . Cada coluna é concatenada
com os valores anteriores separados pelo separador especificado.
Ex.:
private cad(500)
r=tsql_fetch_row_(res, cad, “|”)
6)
tsql_fetch_row_array - lê a proxima linha de um
conjunto resultado em um vetor
int tsql_fetch_row_array( pointer id_resultado, vetor
campos )
id_resultado : identificador de resultado devolvido
por uma chamada sql_query para um commando SQL do tipo
SELECT.
campos: vetor cadeia onde retornarão os valores
dos campos
retorna 0 se existe a linha, se não retorna -1
tsql_fetch_row_array retorna a próxima linha
de um conjunto resultado . Cada coluna é armazenada
numa célula de um array.
Ex.:
n=tsql_num_fields(res)
decl vr[n]=space(20)
r=tsql_fetch_row_array(res, vr)
7)
tsql_affected_rows – número de linhas alteradas
int tsql_affected_rows(pointer id_resultado);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL .
retorna número de linhas alteradas ou -1 se erro
A função se aplica para os commandos SQL
que alteram dados como INSERT, DELETE e UPDATE.
8)
tsql_field_name – devolve o nome de uma coluna
int tsql_field_name(pointer id_resultado, int coluna,
cadeia nome);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado
(a partir de zero)
nome: cadeia que vai receber o nome da coluna
retorna 0 e o nome da coluna ou -1 se erro
9)
tsql_field_type – devolve o tipo de uma coluna
int tsql_field_type(pointer id_resultado, int coluna,
cadeia tipo);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
tipo: cadeia para receber o tipo da coluna
retorna 0 e tipo da coluna ou –1 se erro
10)
tsql_field_length – devolve o tamanho interno de uma
coluna
int tsql_field_length(pointer id_resultado, int coluna);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
retorna tamanho da coluna ou -1 se erro
O tamanho interno equivale ao número de bytes
que é retornado à uma aplicação.
11)
tsql_field_displen – devolve o tamanho de exibição
de uma coluna
int tsql_field_length(pointer id_resultado, int coluna);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
retorna tamanho da coluna ou -1 se erro
A função tsql_field_displen fornece o
número máximo de bytes necessários
para a exibição da coluna. Por exemplo
para um tipo DECIMAL, o tamanho de exibição
será igual ao tamanho interno acrescido de uma
posição, decorrente do ponto decimal.
No caso de um tipo CHAR, os tamanhos internos e de exibição
são iguais.
12)
tsql_field_scale – devolve o tamanho da escala de uma
coluna
int tsql_field_length(pointer id_resultado, int coluna);
id_resultado : identificador de resultado devolvido
por uma chamada tsql_query para um commando SQL do tipo
SELECT.
coluna : número da coluna do conjunto resultado(a
partir de zero)
retorna tamanho da escala da coluna ou –1 se erro
A escala de uma coluna DECIMAL corresponde ao número
máximo de dígitos a direita do ponto decimal.
Para os outros tipos, a escala não é uma
informação relevante.
13)
tsql_free_result - libera recursos de um conjunto resultado
int tsql_free_result ( pointer id_resultado )
id_resultado : identificador de um conjunto resultado
retorna sempre 1
14)
tsql_commit – fecha uma transação
int tsql_commit(pointer id_connexão);
id_conexão : identificador de conexão.
retorna 0 se sucesso, e -1 se erro.
O mesmo efeito pode ser obtido com a execução
do commando SQL, “COMMIT_WORK”. O tempo de execução
de tsql_commit é um pouco menor, tendo em vista
que não é necessário compilar um
commando SQL, e pode se justificar em um ambiente de
muitas transações em paralelo.
15)
tsql_rollback – desfaz uma transação
int tsql_rollback(pointer id_conexão);
id_conexão : identificador de conexão.
retorna 0 se sucesso, e -1 se erro.
O mesmo efeito pode ser obtido com a execução
do commando SQL, ROLLBACK_WORK. O tempo de execução
de tsql_rollback é um pouco menor, tendo em vista
que não é necessário compilar um
comandoSQL, e pode se justificar em um ambiente de muitas
transações em paralelo.
16)
tsql_last_error – Devolve a última mensagem de
erro produzida
int tsql_last_error(cadeia erro);
retorna um cadeia contendo a última mensagem
de erro gerada .
Se não houve erro uma cadeia vazia é retornado
|