API - Rotinas disponíveis na CliSiTef
Neste capítulo, apresentaremos as funções disponíveis na clisitef. Para tanto, serão adotadas as seguintes convenções:
Campo vazio ou não fornecido – na versão padrão é um campo contendo apenas o delimitador (zero binário). Na versão ASCII, se for um campo fixo ele contém espaços. Se for um campo variável ele contém apenas o delimitador de início e final de campo.
Tamanho do campo – no caso de campo de tamanho fixo, quando esse valor for fornecido, indica qual o tamanho mínimo a ser reservado pela aplicação para receber uma resposta do SiTef.
Tipo de parâmetros da função – dividiremos em dois grupos:
Quanto ao fluxo de informações: o parâmetro pode ser de entrada ou saída.
Quando à passagem: o parâmetro pode ser passado por valor ou por referência. Cada rotina descrita neste capítulo, normalmente, possui duas versões/interfaces:
Interface padrão – tradicional, permite parâmetros com dados binários
Interface ASCII – para interface com linguagens de programação, cujos parâmetros trabalham somente em ASCII.
O que diferencia a versão ASCII da versão padrão é o acréscimo do sufixo A no nome das funções, e a forma / tipo de passagem dos parâmetros.