Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Glib::Utils(3)	      User Contributed Perl Documentation	Glib::Utils(3)

NAME
       Glib::Utils -  Miscellaneous utility functions

SYNOPSIS
	 use Glib;
	 Glib::set_application_name (Glib::get_real_name."'s Cool Program");

	 print "app name is ".Glib::get_application_name()."\n";

DESCRIPTION
       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.

METHODS
   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)
       o   $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_prgname
   Glib::set_prgname ($prgname)
       o   $prgname (string)

   string = Glib::get_real_name
       Get the current user's real name.

   string = Glib::strerror ($err)
       o   $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)
       o   $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)
       o   $directory (Glib::UserDirectory)

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

       Since: glib 2.14

ENUMS AND FLAGS
   enum	Glib::UserDirectory
       o   'desktop' / 'G_USER_DIRECTORY_DESKTOP'

       o   'documents' / 'G_USER_DIRECTORY_DOCUMENTS'

       o   'download' /	'G_USER_DIRECTORY_DOWNLOAD'

       o   'music' / 'G_USER_DIRECTORY_MUSIC'

       o   'pictures' /	'G_USER_DIRECTORY_PICTURES'

       o   'public-share' / 'G_USER_DIRECTORY_PUBLIC_SHARE'

       o   'templates' / 'G_USER_DIRECTORY_TEMPLATES'

       o   'videos' / 'G_USER_DIRECTORY_VIDEOS'

SEE ALSO
       Glib

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

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

perl v5.32.1			  2021-02-28			Glib::Utils(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | ENUMS AND FLAGS | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Glib::Utils&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help