DOKK / manpages / debian 12 / libglib-perl / Glib::Utils.3pm.en
Glib::Utils(3pm) User Contributed Perl Documentation Glib::Utils(3pm)

Glib::Utils - Miscellaneous utility functions

  use Glib;
  Glib::set_application_name (Glib::get_real_name."'s Cool Program");
  print "app name is ".Glib::get_application_name()."\n";

Here are some useful miscellaneous utilities. GLib is a portability library, providing portable utility functions for C programs. As such, most of these functions seem to violate the Glib binding principle of not duplicating functionality that Perl already provides, but there's a distinction for each one, i swear. The functions for dealing with user information are provided on all GLib-supported platforms, not just where POSIX (which provides similar information) is available, and even work on platforms where %ENV may not include the expected information. Also, the "application name" referred to by (set|get)_application_name is a human readable name, distinct from the actual program name provided by Perl's own $0.

Get the human-readable application name set by "set_application_name".

Since: glib 2.2

•
$application_name (string)

Set the human-readable application name.

Since: glib 2.2

Find the current user's home directory, by system-dependent/appropriate means.

Computes a list of applicable locale names, which can be used to e.g. construct locale-dependent filenames or search paths. The returned list is sorted from most desirable to least desirable and always contains the default locale "C".

Since: glib 2.6

•
$prgname (string)

Get the current user's real name.

•
$err (integer)

Return a string describing the given errno value, like "No such file or directory" for ENOENT. This is translated into the user's preferred language and is a utf8 wide-char string (unlike a $! string (perlvar) or POSIX::strerror (POSIX) which are locale codeset bytes).

•
$signum (integer)

Return a string describing the given signal number, like "Segmentation violation" for SIGSEGV. This is translated into the user's preferred language and is a utf8 wide-char string.

Returns an ordered list of base directories in which to access system-wide configuration information.

Since: glib 2.6

Returns an ordered list of base directories in which to access system-wide application data.

Since: glib 2.6

Get the temp dir as appropriate for the current system. See the GLib docs for info on how it works.

Gets the base directory in which to store non-essential, cached data specific to particular user.

Since: glib 2.6

Gets the base directory in which to store user-specific application configuration information such as user preferences and settings.

Since: glib 2.6

Get the base directory for application data such as icons that is customized for a particular user.

Since: glib 2.6

Get the current user's name by whatever system-dependent means necessary.

•
$directory (Glib::UserDirectory)

Returns the full path of a special directory using its logical id.

Since: glib 2.14

  • 'desktop' / 'G_USER_DIRECTORY_DESKTOP'
  • 'documents' / 'G_USER_DIRECTORY_DOCUMENTS'
  • 'download' / 'G_USER_DIRECTORY_DOWNLOAD'
  • 'music' / 'G_USER_DIRECTORY_MUSIC'
  • 'pictures' / 'G_USER_DIRECTORY_PICTURES'
  • 'public-share' / 'G_USER_DIRECTORY_PUBLIC_SHARE'
  • 'templates' / 'G_USER_DIRECTORY_TEMPLATES'
  • 'videos' / 'G_USER_DIRECTORY_VIDEOS'

Glib

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL. See Glib for a full notice.

2022-10-19 perl v5.36.0