Top | ![]() |
![]() |
![]() |
![]() |
#define | gettext() |
#define | ngettext() |
#define | _() |
#define | N_() |
#define | GWY_SWAP() |
#define | gwy_strequal() |
#define | GWY_CLAMP() |
#define | gwy_clear() |
#define | gwy_object_unref() |
#define | gwy_signal_handler_disconnect() |
#define | GWY_FIND_PSPEC() |
#define | gwy_debug() |
#define | gwy_info() |
void | gwy_debug_gnu () |
#define GWY_SWAP(t, x, y)
Swaps two variables (more precisely lhs and rhs expressions) of type t
in a single statement.
#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()
.
#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.
array |
Pointer to an array of values to clear. This argument may be evaluated several times. |
|
n |
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
).
#define gwy_debug(format...)
Emits a debugging message to the program log.
The message is amended with additional information such as source file,
line number or time (when possible) and emitted at log level
G_LOG_LEVEL_DEBUG
via g_log()
.
It should be noted that the default GLib log handler discards
G_LOG_LEVEL_DEBUG
messages but the default Gwyddion handler does not.
The macro expands to nothing if compiled without DEBUG defined.
#define gwy_info(format...)
Emits an informational message.
The message is emitted at log level G_LOG_LEVEL_INFO
via g_log()
. This
macro is primarily meant for reporting of non-fatal issues in file import
modules.
It should be noted that the default GLib log handler discards
G_LOG_LEVEL_INFO
messages but the default Gwyddion handler does not.
Since: 2.45
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.