| Top | Description |
#include <libgwyddion/gwyddion.h> #define gettext (x) #define ngettext (sing, plur, n) #define _ (x) #define N_ (x) #define GWY_SWAP (t, x, y) #define gwy_strequal (a, b) #define GWY_CLAMP (x, low, hi) #define gwy_clear (array, n) #define gwy_object_unref (obj) #define gwy_signal_handler_disconnect (obj, hid) #define GWY_FIND_PSPEC (type, id, spectype) #define gwy_debug (...) void gwy_debug_gnu (const gchar *domain,const gchar *fileline,const gchar *funcname,const gchar *format,...);
#define GWY_SWAP(t, x, y)
Swaps two variables (more precisely lhs and rhs expressions) of type t
in a single statement.
|
A C type. |
|
A variable of type t to swap with x. |
|
A variable of type t to swap with y. |
#define gwy_strequal(a, b)
Expands to TRUE if strings are equal, to FALSE otherwise.
|
A string. |
|
Another string. |
#define GWY_CLAMP(x, low, hi)
Ensures that x is between the limits set by low and hi.
This macro differs from GLib's CLAMP() by G_UNLIKELY() assertions on the
tests that x is smaller than low and larger than hi. This makes x
already being in the right range the fast code path.
It is supposed to be used on results of floating-point operations that
should fall to a known range but may occasionaly fail to due to rounding
errors and in similar situations. Under normal circumstances, use CLAMP().
|
The value to clamp. |
|
The minimum value allowed. |
|
The maximum value allowed. |
#define gwy_clear(array, n)
Fills memory block representing an array with zeroes.
This is a shorthand for memset, with the number of bytes to fill calculated from the type of the pointer.
|
Pointer to an array of values to clear. This argument may be evaluated several times. |
|
Number of items to clear. |
Since 2.12
#define gwy_object_unref(obj)
Unreferences an object if it exists.
If obj is not NULL, g_object_unref() is called on it.
In all cases obj is set to NULL.
A useful property of this macro is its idempotence.
If the object reference count is greater than one, assure it should be referenced elsewhere, otherwise it leaks memory.
#define gwy_signal_handler_disconnect(obj, hid)
Disconnect a signal handler if it exists.
If hid is nonzero and obj is not NULL, the signal handler identified by
hid is disconnected. In all cases hid is set to 0.
A useful property of this macro is its idempotence.
#define GWY_FIND_PSPEC(type, id, spectype)
A convenience g_object_class_find_property() wrapper.
It expands to property spec cast to correct type (spec).
|
Object type (e.g. GWY_TYPE_CONTAINER). |
|
Property id. |
|
Param spec type (e.g. DOUBLE). |
#define gwy_debug(format...)
Prints a debugging message.
Does nothing if compiled without DEBUG defined.
void gwy_debug_gnu (const gchar *domain,const gchar *fileline,const gchar *funcname,const gchar *format,...);
Print a debugging message.
To be used via gwy_debug(), should not be used directly.
|
Log domain. |
|
File and line info. |
|
Function name. |
|
Message format. |
|
Message parameters. |