XCore Exchange

Where is this defined? What is the purpose? It is not documented anywhere that we can find?

Please refer to xccompat.h from the toolchain install folder::

#ifdef __XC__
#define REFERENCE_PARAM(type, name) type &name
#else
#define REFERENCE_PARAM(type, name) type *name
#endif


Useful for api defines when used across *.xc and *.c files.

In XC you can pass by reference (as in c++).
In C you must pass by pointer.
Historically, XC did not offer pointers, hence the need for macro magic in header files used by both.
Post compilation, referecence and C-pointers are the same hence why it is safe to munge in this way.

Dear Sir,
This description is also troubled me.
1.I am unable to find out where "__XC__" is defined.
2.or does it mean "__XC__ is defined" is default setting for .xc files ?

Thanks

#ifdef __XC__
#define REFERENCE_PARAM(type, name) type &name
#else
#define REFERENCE_PARAM(type, name) type *name
#endif

__XC__ gets set automatically when compiling.xc files. As srinie says, thus macro is useful when declaring and writing functions that need to be callable from xc or c