GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GLIB::UTILS (3)

.ds Aq ’

NAME

Glib::Utils - Miscellaneous utility functions

CONTENTS

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 GLIB::UTILS (3) 2016-04-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.