Compiler support

Compiler-level abstraction.

Summary

Compiler support	Compiler-level abstraction.
Global Declaration Macros	These macros are meant to be used to delimit declarations in public header files.
NACORE_BEGIN_C_DECLS	Delimits the beginning of public declarations.
NACORE_END_C_DECLS	Delimits the end of public declarations.
Symbol Declaration Macros	These macros are meant to be used for SINGLE symbol declarations (variables or functions) by prepending them to such declarations.
NACORE_IMPORT	Specifies that a symbol is imported from a library.
NACORE_EXPORT	Specifies that a symbol is to be exported.
NACORE_PUBLIC	Specifies that a symbol is publicly visible.
NACORE_PRIVATE	Specifies that a symbol has hidden visibility.
NACORE_FORMAT_PRINTF(string_index, first_to_check)	Specifies that a function takes printf()-style arguments.
NACORE_FORMAT_VPRINTF(string_index)	Specifies that a function takes vprintf()-style arguments.

These macros are meant to be used to delimit declarations in public header files.

myheader.h

#ifndef MY_HEADER_H
#define MY_HEADER_H

NACORE_BEGIN_C_DECLS

... blah blah blah ...

NACORE_END_C_DECLS

#endif

Delimits the beginning of public declarations.

So that C++ compilers don’t mangle their names.

Delimits the end of public declarations.

So that C++ compilers don’t mangle their names.

These macros are meant to be used for SINGLE symbol declarations (variables or functions) by prepending them to such declarations.

They can be combined together, unless otherwise told.

myfunc.h

NACORE_PUBLIC void myfunc();

myfunc.c

NACORE_PUBLIC void
myfunc()
{
        ... blah blah blah ...
}

Specifies that a symbol is imported from a library.

Cannot be combined with NACORE_EXPORT.

Specifies that a symbol is to be exported.

Cannot be combined with NACORE_IMPORT.

Specifies that a symbol is publicly visible.

Cannot be combined with NACORE_PRIVATE.

Specifies that a symbol has hidden visibility.

Cannot be combined with NACORE_PUBLIC.

Specifies that a function takes printf()-style arguments.

string_index	Index of the format string argument (starting from 1).
first_to_check	Index of the first argument to be checked against the format string (starting from 1).

Specifies that a function takes vprintf()-style arguments.

string_index

Index of the format string argument (starting from 1).