4.8 Higher-level language bindings – introducing the semantic API

The semantic API is an XML file describing the API. It is available through pkg-config:

pkg-config --variable=semantic_api libtarot

The API has a few concepts. The top-level element is named ’api’, but it does not carry useful information. Inside this API, you may find exactly one namespace, with an attribute, ‘name’. ‘name’ is exactly “tarot”.

Under the namespace, you find:

• the ‘typedef’’s, like ‘TarotCard’ and such;
• the ‘constant’’s, like ‘TAROT_EXCUSE’;
• the ‘enumeration’’s, like ‘TarotBid’;
• the ‘class’’es, like ‘TarotGame’;
• the ‘struct’’s, like ‘TarotGameCardAnalysis’;
• and the top-level function, named ‘method’.

Inside each type, you will also find methods applicable to that type. A method is composed of:

• the name of the C function to call;
• a ‘return’ type;
• an optional ‘instance’ parameter (otherwise, this is a top-level function, or a static method);
• some ‘parameter’’s.