Interface Modules Overview
If your programming language does not have an interface, check if your compiler supports mixed language calls. If so, you may be able to use the C interface.
Table 27
Btrieve Language Interface Source Modules 
Language
Compiler
Source Module
C/C++
•
Most C/C++ compilers, including Embarcadero, Microsoft, and WATCOM.
This interface provides multiple platform support.
•
Embarcadero C++ Builder
•
BlobHdr.h (for Extended DOS platforms using Embarcadero or Phar Lap only)
•
BtiTypes.h (platform-independent data types)
•
BtrApi.h (Btrieve function prototypes)
•
BtrApi.c (MicroKernel Engine code for all platforms)
•
BtrConst.h (common Btrieve constants)
•
BtrSamp.c (sample program)
•
CBBtrv.cpp
•
CBBtrv.mak
•
CBBMain.cpp
•
CBBMain.dfm
•
CBBMain.h
Delphi
•
Embarcadero Delphi 1
•
Embarcadero Delphi 3 and above
•
BtrConst.pas (common Btrieve constants)
•
Btr32.dpr
•
Btr32.dof
•
BtrSam32.dfm
•
BtrSam32.pas (sample program)
•
BtrApi32.pas
•
BtrConst.pas (common Btrieve constants)
Pascal
•
Borland Turbo Pascal 5 – 6
•
Borland Pascal 7 for DOS
•
Extended DOS Pascal for Turbo Pascal 7
•
Borland Turbo Pascal 1.5
•
Borland Pascal 7 for Windows
•
BtrApid.pas
•
BtrSampd.pas (sample program)
•
BtrConst.pas (common Btrieve constants)
•
BlobHdr.pas
•
BtrApiw.pas
•
BtrSampw.pas (sample program)
Visual Basic
•
Microsoft Visual Basic for Windows NT and Windows 9X
•
BtSamp32.vbp
•
BtrSam32.bas (sample program)
•
BtrFrm32.frm
The following table provides a comparison of some common data types used in data buffers for Btrieve operations, such as Create and Stat.
Table 28
Common Data Types Used in the Btrieve Data Buffer
Assembly
C
COBOL
Delphi
Pascal
Visual Basic
doubleword
long1
PIC 9(4)
longint1
longint1
Long integer
word
short int1
PIC 9(2)
smallint1
integer1
Integer
byte
char
PIC X
char
char
String
byte
unsigned char
PIC X
byte
byte
Byte
1The value of integers depends on the environment in which you develop. In 32-bit environments, integers are the same as long integers. In 16-bit environments, integers are the same as short, or small, integers.
Programming Notes
Calling a Btrieve function always returns an INTEGER value that corresponds to a status code. After a Btrieve call, your application should always check the value of this status code. A Status Code of 0 indicates a successful operation. Your application must be able to recognize and resolve a non-zero status.
Although you must provide all parameters on every call, the MicroKernel does not use every parameter for every operation. See the Btrieve API Guide for a more detailed description of the parameters that are relevant for each operation.