![]() |
![]() |
Gwyddion Library Reference Manual | ![]() |
|
---|---|---|---|---|
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. |