утилиты и функции обработки ошибок

gchar *g_strdup( const gchar *str );

функция замены strdup. копирует оригинальное содержимое строк в недавно выделенную память и возвращает указатель на неё.

gchar *g_strerror( gint errnum );

я рекомендую использовать это для всех сообщений об ошибках. это намного лучше и более портативно чем perror() или другие функции. вывод имеет обычно форму:

program name:function that failed:file or further description:strerror

вот - пример одного такого вызова, используемого в нашей программме hello_world:

g_print("hello_world:open:%s:%s\n", filename, g_strerror(errno));

void g_error( gchar *format, ... );

печатает сообщение об ошибках. формат такой же как у printf, но добавляет "** error **: " к вашему сообщению и выходит из программмы. используйте только для неустранимых ошибок.

void g_warning( gchar *format, ... );

тоже что и выше но перед сообщением выводит "** warning **: " и не выходит из программмы.

void g_message( gchar *format, ... );

печатает "message: " перед помещенной строкой.

void g_print( gchar *format, ... );

замена для printf().

и наша старая функция:

gchar *g_strsignal( gint signum );

распечатывает название сигнала системы unix, получая номер сигнала. полезен в основном функциям обрабатывающим сигналы.

всё вышеописанное взято из glib.h и это лишь небольшая часть. если вы захотите документировать какую нибудь функцию сообщите мне об этом!