GKSu Hackers Utility Functions Guide

GKSu Hackers Utility Functions Guide —

Synopsis




gchar*      conv_from_utf8                  (gchar *msg);
gchar*      conv_to_utf8                    (gchar *msg);
void        gk_dialog                       (GtkMessageType type,
                                             gchar *format,
                                             ...);

Description

Details

conv_from_utf8 ()

gchar*      conv_from_utf8                  (gchar *msg);

Converts a string from UTF-8 to the current locale. It is mostly a wrapper to Glib's g_locale_from_utf8().

msg: message to convert from UTF-8.
Returns : a newly allocated with the converted string or NULL on failure.

conv_to_utf8 ()

gchar*      conv_to_utf8                    (gchar *msg);

Converts a string from the current locale to UTF-8. It is mostly a wrapper to Glib's g_locale_to_utf8().

msg: message to convert to UTF-8.
Returns : a newly allocated with the converted string or NULL on failure.

gk_dialog ()

void        gk_dialog                       (GtkMessageType type,
                                             gchar *format,
                                             ...);

Shows 'msg' in a dialog box with an OK button This function is to be a helper for functions needing to display some information to the user. Notice that it will not let the program go on if the user does not close the dialog.

type: a GtkMessageType (GTK_MESSAGE_{INFO,ERROR,WARNING})
format: a printf()-like format for the label of the dialog
...: the actual variables.