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
Probe::Perl(3) User Contributed Perl Documentation Probe::Perl(3)

Probe::Perl - Information about the currently running perl

version 0.03

 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

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.

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

Randy W. Sims <randys@thepierianspring.org>

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

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.

2013-08-08 perl v5.32.1

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

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