Typedefs | |
typedef void * | tQSL_Converter |
Functions | |
int | tqsl_beginADIFConverter (tQSL_Converter *conv, const char *filename, tQSL_Cert *certs, int ncerts, tQSL_Location loc) |
int | tqsl_beginCabrilloConverter (tQSL_Converter *conv, const char *filename, tQSL_Cert *certs, int ncerts, tQSL_Location loc) |
int | tqsl_endConverter (tQSL_Converter *conv) |
int | tqsl_setConverterAllowBadCall (tQSL_Converter conv, int allow) |
int | tqsl_setADIFConverterDateFilter (tQSL_Converter conv, tQSL_Date *start, tQSL_Date *end) |
const char * | tqsl_getConverterGABBI (tQSL_Converter conv) |
int | tqsl_getConverterCert (tQSL_Converter conv, tQSL_Cert *certp) |
int | tqsl_getConverterLine (tQSL_Converter conv, int *lineno) |
const char * | tqsl_getConverterRecordText (tQSL_Converter conv) |
|
Initiates the conversion process for an ADIF file.
tqsl_endConverter() should be called to free the resources when the conversion is finished. |
|
Initiates the conversion process for a Cabrillo file.
tqsl_endConverter() should be called to free the resources when the conversion is finished. |
|
End the conversion process by freeing the used resources. |
|
Get the certificate used to sign the most recent QSO record. |
|
This is the main converter function. It returns a single GABBI record. Returns the NULL pointer on error or EOF. (Test tQSL_Error to determine which.) tQSL_Error is set to TQSL_DATE_OUT_OF_RANGE if QSO date range checking is active (see ::tqsl_useADIFConverterDateFilter) and the QSO date is outside the specified range. This is a non-fatal error. N.B. On systems that distinguish text-mode files from binary-mode files, notably Windows, the GABBI records should be written in binary mode. N.B. If the selected certificate has not been initialized for signing via tqsl_beginSigning(), this function will return a TQSL_SIGNINIT_ERROR. The cert that caused the error can be obtained via tqsl_getConverterCert(), initialized for signing, and then this function can be called again. No data records will be lost in this process. |
|
Get the input-file line number last read by the converter, starting at line 1. |
|
Get the text of the last record read by the converter. Returns NULL on error. |
|
Set QSO date filtering in the converter.
If |
|
Configure the converter to allow (allow != 0) or disallow (allow == 0) nonamateur call signs in the CALL field. (Note: the test for validity is fairly trivial and will allow some nonamateur calls to get through, but it does catch most common errors.)
|