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  -  PRIMA::UTILS (3)

.ds Aq ’

NAME

Prima::Utils - miscellanneous routines

CONTENTS

DESCRIPTION

The module contains several helper routines, implemented in both C and perl. Whereas the C-coded parts are accessible only if ’use Prima;’ statement was issued prior to the ’use Prima::Utils’ invocation, the perl-coded are always available. This makes the module valuable when used without the rest of toolkit code.

API

alarm $TIMEOUT, $SUB, @PARAMS Calls SUB with PARAMS after TIMEOUT milliseconds.
beep [ FLAGS = mb::Error ] Invokes the system-depended sound and/or visual bell, corresponding to one of following constants:



        mb::Error
        mb::Warning
        mb::Information
        mb::Question



get_gui Returns one of gui::XXX constants, reflecting the graphic user interface used in the system:



        gui::Default
        gui::PM 
        gui::Windows
        gui::XLib
        gui::GTK2



get_os Returns one of apc::XXX constants, reflecting the platfrom. Currently, the list of the supported platforms is:



        apc::Win32 
        apc::Unix



ceil DOUBLE Obsolete function.

Returns stdlib’s ceil() of DOUBLE

find_image PATH Converts PATH from perl module notation into a file path, and searches for the file in @INC paths set. If a file is found, its full filename is returned; otherwise undef is returned.
floor DOUBLE Obsolete function.

Returns stdlib’s floor() of DOUBLE

getdir PATH Reads content of PATH directory and returns array of string pairs, where the first item is a file name, and the second is a file type.

The file type is a string, one of the following:



        "fifo" - named pipe
        "chr"  - character special file
        "dir"  - directory
        "blk"  - block special file
        "reg"  - regular file
        "lnk"  - symbolic link
        "sock" - socket
        "wht"  - whiteout



This function was implemented for faster directory reading, to avoid successive call of stat for every file.

last_error Returns last system error, if any
path [ FILE ] If called with no parameters, returns path to a directory, usually ~/.prima, that can be used to contain the user settings of a toolkit module or a program. If FILE is specified, appends it to the path and returns the full file name. In the latter case the path is automatically created by File::Path::mkpath unless it already exists.
post $SUB, @PARAMS Postpones a call to SUB with PARAMS until the next event loop tick.
query_drives_map [ FIRST_DRIVE = ‘‘A:’’ ] Returns anonymous array to drive letters, used by the system. FIRST_DRIVE can be set to other value to start enumeration from. Some OSes can probe eventual diskette drives inside the drive enumeration routines, so there is a chance to increase responsiveness of the function it might be reasonable to set FIRST_DRIVE to C: string.

If the system supports no drive letters, empty array reference is returned ( unix ).

query_drive_type DRIVE Returns one of dt::XXX constants, describing the type of drive, where DRIVE is a 1-character string. If there is no such drive, or the system supports no drive letters ( unix ), dt::None is returned.



        dt::None
        dt::Unknown
        dt::Floppy
        dt::HDD
        dt::Network
        dt::CDROM
        dt::Memory



sound [ FREQUENCY = 2000, DURATION = 100 ] Issues a tone of FREQUENCY in Hz with DURATION in milliseconds.
username Returns the login name of the user. Sometimes is preferred to the perl-provided getlogin ( see getlogin in perlfunc ) .
xcolor COLOR Accepts COLOR string on one of the three formats:



        #rgb
        #rrggbb
        #rrrgggbbb



and returns 24-bit RGB integer value.

AUTHOR

Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

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


perl v5.20.3 PRIMA::UTILS (3) 2015-10-12

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