config.h File Reference

Go to the source code of this file.

Macros
#define	LSST_CONTROL_FIELD(NAME, TYPE, DOC)
	A preprocessor macro used to define fields in C++ "control object" structs.
#define	LSST_NESTED_CONTROL_FIELD(NAME, MODULE, TYPE, DOC)
	A preprocessor macro used to define fields in C++ "control object" structs, for nested control objects.

Macro Definition Documentation

LSST_CONTROL_FIELD

#define LSST_CONTROL_FIELD	(		NAME,
			TYPE,
			DOC )

Value:

    static char const * _doc_ ## NAME() {               \
        static char const * doc = DOC;                  \
        return doc;                                     \
    }                                                   \
    static char const * _type_ ## NAME() {              \
        static char const * type = #TYPE;               \
        return type;                                    \
    }                                                   \
    TYPE NAME

A preprocessor macro used to define fields in C++ "control object" structs.

These objects can then be wrapped into full-fledged Config objects by the functions in lsst.pex.config.wrap.

The defaults for the config class will be set properly if and only if the control class is default-constructable.

See lsst.pex.config.wrap.makeConfigClass for a complete example of how to use this macro.

Definition at line 43 of file config.h.

#define LSST_CONTROL_FIELD(NAME, TYPE, DOC)             \
    static char const * _doc_ ## NAME() {               \
        static char const * doc = DOC;                  \
        return doc;                                     \
    }                                                   \
    static char const * _type_ ## NAME() {              \
        static char const * type = #TYPE;               \
        return type;                                    \
    }                                                   \
    TYPE NAME

LSST_NESTED_CONTROL_FIELD

#define LSST_NESTED_CONTROL_FIELD	(		NAME,
			MODULE,
			TYPE,
			DOC )

Value:

    static char const * _doc_ ## NAME() {                        \
        static char const * doc = DOC;                           \
        return doc;                                              \
    }                                                            \
    static char const * _type_ ## NAME() {                       \
        static char const * type = #TYPE;                        \
        return type;                                             \
    }                                                            \
    static char const * _module_ ## NAME() {                     \
        static char const * mod = #MODULE;                       \
        return mod;                                              \
    }                                                            \
    TYPE NAME

A preprocessor macro used to define fields in C++ "control object" structs, for nested control objects.

These can be wrapped into Config objects by the functions in lsst.pex.config.wrap.

The nested object will be held as a regular, by-value data member (there's currently no way to use smart pointers or getters/setters instead).

The nested control object class must also be wrapped into a config object, and the Python module of the wrapped nested control object must be passed as the MODULE argument to the macro. When a wrapped control object is used as a nested field in the same package it is defined in, the MODULE argument must refer to the actual wrapped module, not the just the package, even if the name is lifted into the package namespace.

See lsst.pex.config.wrap.makeConfigClass for a complete example of how to use this macro.

Definition at line 69 of file config.h.

#define LSST_NESTED_CONTROL_FIELD(NAME, MODULE, TYPE, DOC)       \
    static char const * _doc_ ## NAME() {                        \
        static char const * doc = DOC;                           \
        return doc;                                              \
    }                                                            \
    static char const * _type_ ## NAME() {                       \
        static char const * type = #TYPE;                        \
        return type;                                             \
    }                                                            \
    static char const * _module_ ## NAME() {                     \
        static char const * mod = #MODULE;                       \
        return mod;                                              \
    }                                                            \
    TYPE NAME