Using the library in your C code

C programs need only include the single header file ojcardlib.h, and link against the shared library (libojcard.so on Linux, ojcard.dll on Windows). The library will initialize itself properly, including properly seeding the random number generator. If you build the library yourself and link it statically, you will have to initialize the library yourself, like this:

int main(int argc, char *argv[]) {
    oj_init_library(0);
    . . .
}

The argument 0 tells the library to seed the RNG from system entropy, which is what you want in most cases. If you pass a nonzero value, that will be used to seed the RNG, which will then generate a reproducible sequence sometimes useful for testing. It is safe to call this initialization function even if it has been called previously (as it would be by the shared library).

• Types: Data types and structures used by the C API.
• Text functions: Functions for input and output of card information as text.
• Card list functions: Functions for manipulating card lists.
• Combiner functions: Functions for producing combinations of cards.
• Poker functions: Specialized functions for poker.
• Blackjack functions: Specialized functions for blackjack.
• Miscellaneous functions: Functions that don’t fit elsewhere.
• Examples: Sample complete programs.