Glib::Utils - Miscellaneous utility functions

Copyright (C) 2003-2011 by the gtk2-perl team. This software is licensed under the LGPL. See Glib for a full notice. perl v5.40.0 2024-10-20 Glib::Utils(3pm)

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.

enumGlib::UserDirectory • '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'

string=Glib::get_application_name Get the human-readable application name set by "set_application_name". Since: glib 2.2 Glib::set_application_name($application_name) • $application_name (string) Set the human-readable application name. Since: glib 2.2 string=Glib::get_home_dir Find the current user's home directory, by system-dependent/appropriate means. list=Glib::get_language_names 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 string=Glib::get_prgnameGlib::set_prgname($prgname) • $prgname (string) string=Glib::get_real_name Get the current user's real name. string=Glib::strerror($err) • $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). string=Glib::strsignal($signum) • $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. list=Glib::get_system_config_dirs Returns an ordered list of base directories in which to access system-wide configuration information. Since: glib 2.6 list=Glib::get_system_data_dirs Returns an ordered list of base directories in which to access system-wide application data. Since: glib 2.6 string=Glib::get_tmp_dir Get the temp dir as appropriate for the current system. See the GLib docs for info on how it works. string=Glib::get_user_cache_dir Gets the base directory in which to store non-essential, cached data specific to particular user. Since: glib 2.6 string=Glib::get_user_config_dir Gets the base directory in which to store user-specific application configuration information such as user preferences and settings. Since: glib 2.6 string=Glib::get_user_data_dir Get the base directory for application data such as icons that is customized for a particular user. Since: glib 2.6 string=Glib::get_user_name Get the current user's name by whatever system-dependent means necessary. string=Glib::get_user_special_dir($directory) • $directory (Glib::UserDirectory) Returns the full path of a special directory using its logical id. Since: glib 2.14

Glib::Utils - Miscellaneous utility functions

Glib

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