| Shell Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
char * shell_get_file_contents_utf8_sync (const char *path,GError **error); gboolean shell_session_is_active_for_systemd (void); GdkPixbuf * shell_util_create_pixbuf_from_data (const guchar *data,gsize len,GdkColorspace colorspace,gboolean has_alpha,int bits_per_sample,int width,int height,int rowstride); char * shell_util_format_date (const char *format,gint64 time_ms); void shell_util_get_transformed_allocation (ClutterActor *actor,ClutterActorBox *box); int shell_util_get_week_start (void); char * shell_util_normalize_and_casefold (const char *str); void shell_util_set_hidden_from_pick (ClutterActor *actor,gboolean hidden); gboolean shell_util_wifexited (int status,int *exit); gboolean shell_write_string_to_stream (GOutputStream *stream,const char *str,GError **error);
char * shell_get_file_contents_utf8_sync (const char *path,GError **error);
Synchronously load the contents of a file as a NUL terminated string, validating it as UTF-8. Embedded NUL characters count as invalid content.
|
UTF-8 encoded filename path |
|
a GError |
Returns : |
File contents. [transfer full] |
gboolean shell_session_is_active_for_systemd (void);
Checks whether the session we are running in is currently active, i.e. in the foreground and ready for user input.
Returns : |
TRUE if session is active |
GdkPixbuf * shell_util_create_pixbuf_from_data (const guchar *data,gsize len,GdkColorspace colorspace,gboolean has_alpha,int bits_per_sample,int width,int height,int rowstride);
Workaround for non-introspectability of gdk_pixbuf_from_data().
|
. [array length=len][element-type guint8][transfer full] |
Returns : |
. [transfer full] |
char * shell_util_format_date (const char *format,gint64 time_ms);
Formats a date for the current locale. This should be used instead of the Spidermonkey Date.toLocaleFormat() extension because Date.toLocaleFormat() is buggy for Unicode format strings: https://bugzilla.mozilla.org/show_bug.cgi?id=508783
|
a strftime-style string format, as parsed by
g_date_time_format()
|
|
milliseconds since 1970-01-01 00:00:00 UTC; the value returned by Date.getTime() |
Returns : |
the formatted date. If the date is outside of the range of a GDateTime (which contains any plausible dates we actually care about), will return an empty string. |
void shell_util_get_transformed_allocation (ClutterActor *actor,ClutterActorBox *box);
This function is similar to a combination of clutter_actor_get_transformed_position(),
and clutter_actor_get_transformed_size(), but unlike
clutter_actor_get_transformed_size(), it always returns a transform
of the current allocation, while clutter_actor_get_transformed_size() returns
bad values (the transform of the requested size) if a relayout has been
queued.
This function is more convenient to use than
clutter_actor_get_abs_allocation_vertices() if no transformation is in effect
and also works around limitations in the GJS binding of arrays.
|
a ClutterActor |
|
location to store returned box in stage coordinates. [out] |
int shell_util_get_week_start (void);
Gets the first week day for the current locale, expressed as a number in the range 0..6, representing week days from Sunday to Saturday.
Returns : |
A number representing the first week day for the current locale |
void shell_util_set_hidden_from_pick (ClutterActor *actor,gboolean hidden);
If hidden is TRUE, hide actor from pick even with a mode of
CLUTTER_PICK_ALL; if hidden is FALSE, unhide actor.
|
A ClutterActor |
|
Whether actor should be hidden from pick |
gboolean shell_util_wifexited (int status,int *exit);
Implements libc standard WIFEXITED, that cannot be used JS code.
|
the status returned by wait() or waitpid()
|
|
the actual exit status of the process. [out] |
Returns : |
TRUE if the process exited normally, FALSE otherwise |
gboolean shell_write_string_to_stream (GOutputStream *stream,const char *str,GError **error);
Write a string to a GOutputStream as UTF-8. This is a workaround for not having binary buffers in GJS.
|
a GOutputStream |
|
a UTF-8 string to write to stream
|
|
location to store GError |
Returns : |
TRUE if write succeeded |