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  -  PROBE::PERL (3)

.ds Aq ’

NAME

Probe::Perl - Information about the currently running perl

CONTENTS

VERSION

version 0.03

SYNOPSIS



 use Probe::Perl;
 $p = Probe::Perl->new();

 # Version of this perl as a floating point number
 $ver = $p->perl_version();
 $ver = Probe::Perl->perl_version();

 # Convert a multi-dotted string to a floating point number
 $ver = $p->perl_version_to_float($ver);
 $ver = Probe::Perl->perl_version_to_float($ver);

 # Check if the given perl is the same as the one currently running
 $bool = $p->perl_is_same($perl_path);
 $bool = Probe::Perl->perl_is_same($perl_path);

 # Find a path to the currently-running perl
 $path = $p->find_perl_interpreter();
 $path = Probe::Perl->find_perl_interpreter();

 # Get @INC before run-time additions
 @paths = $p->perl_inc();
 @paths = Probe::Perl->perl_inc();

 # Get the general type of operating system
 $type = $p->os_type();
 $type = Probe::Perl->os_type();

 # Access Config.pm values
 $val = $p->config(foo);
 $val = Probe::Perl->config(foo);
 $p->config(foo => bar);  # Set locally
 $p->config_revert(foo);  # Revert



DESCRIPTION

This module provides methods for obtaining information about the currently running perl interpreter. It originally began life as code in the Module::Build project, but has been externalized here for general use.

METHODS

new() Creates a new Probe::Perl object and returns it. Most methods in the Probe::Perl packages are available as class methods, so you don’t always need to create a new object. But if you want to create a mutable view of the Config.pm data, it’s necessary to create an object to store the values in.
config( $key [, $value] ) Returns the Config.pm value associated with $key. If $value is also specified, then the value is set to $value for this view of the data. In this case, config() must be called as an object method, not a class method.
config_revert( $key ) Removes any user-assigned value in this view of the Config.pm data.
find_perl_interpreter( ) Returns the absolute path of this perl interpreter. This is actually sort of a tricky thing to discover sometimes - in these cases we use perl_is_same() to verify.
perl_version( ) Returns the version of this perl interpreter as a perl-styled version number using perl_version_to_float(). Uses $^V if your perl is recent enough, otherwise uses $].
perl_version_to_float( $version ) Formats $version as a perl-styled version number like 5.008001.
perl_is_same( $perl ) Given the name of a perl interpreter, this method determines if it has the same configuration as the one represented by the current perl instance. Usually this means it’s exactly the same
perl_inc( ) Returns a list of directories in this perl’s @INC path, before any entries from use lib, $ENV{PERL5LIB}, or -I switches are added.
os_type( [$osname] ) Returns a generic OS type (e.g. Unix, Windows, MacOS) for the given OS name. If no OS name is given it uses the value in $^O, which is the same as $Config{osname}.

AUTHOR

Randy W. Sims <randys@thepierianspring.org>

Based partly on code from the Module::Build project, by Ken Williams <kwilliams@cpan.org> and others.

COPYRIGHT

Copyright 2005 Ken Williams and Randy Sims. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

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


perl v5.20.3 PROBE::PERL (3) 2013-08-08

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