apr::os(3pm) [debian man page]

libapache2-mod-perl2-2.0.7::docs::api::APR::OS(3pm)	User Contributed Perl Documentation    libapache2-mod-perl2-2.0.7::docs::api::APR::OS(3pm)

NAME

       APR::OS - Perl API for Platform-specific APR API

Synopsis
	 use APR::OS ();

	 # get current thread id
	 my $tid = APR::OS::current_thread_id();

Description
       "APR::OS" provides the Perl interface to platform-specific APR API.

       You should be extremely careful when relying on any of the API provided by this module, since they are no portable. So if you use those you
       application will be non-portable as well.

API

       "APR::OS" provides the following methods:

   "current_thread_id"
       Get the current thread ID

	 $tid = APR::OS::current_thread_id();

       ret: $tid ( integer )
	   under threaded MPMs returns the current thread ID, otherwise 0.

       since: 2.0.00

       Example:

	   use Apache2::MPM ();
	   use APR::OS ();
	   if (Apache2::MPM->is_threaded) {
	       my $tid_obj = APR::OS::current_thread_id();
	       print "TID: $tid";
	   }
	   else {
	       print "PID: $$";
	   }

See Also
       mod_perl 2.0 documentation.

Copyright
       mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors
       The mod_perl development team and numerous contributors.

perl v5.14.2							    2011-02-08		       libapache2-mod-perl2-2.0.7::docs::api::APR::OS(3pm)

libapache2-mod-perl2-2.0.7::docs::api::APR::UUID(3pm)	User Contributed Perl Documentation  libapache2-mod-perl2-2.0.7::docs::api::APR::UUID(3pm)

NAME

       APR::UUID - Perl API for manipulating APR UUIDs

Synopsis
	 use APR::UUID ();

	 # get a random UUID and format it as a string
	 my $uuid = APR::UUID->new->format;
	 # $uuid = e.g. 'd48889bb-d11d-b211-8567-ec81968c93c6';

	 # same as the object returned by APR::UUID->new
	 my $uuid_parsed = APR::UUID->parse($uuid);

Description
       "APR::UUID" is used to get and manipulate random UUIDs.

       It allows you to "create" random UUIDs, which when "formatted" returns a string like:

	 'd48889bb-d11d-b211-8567-ec81968c93c6';

       which can be parsed back into the "APR::UUID" object with "parse()".

API

       "APR::UUID" provides the following functions and/or methods:

   "format"
       Convert an "APR::UUID object" object into a string presentation:

	 my $uuid_str = $uuid->format;

       obj: $uuid ( "APR::UUID object" )
       ret: $uuid_str
	   returns a string representation of the object (.e.g 'd48889bb-d11d-b211-8567-ec81968c93c6').

       since: 2.0.00

   "new"
       Create a "APR::UUID object" using the random engine:

	 my $uuid = APR::UUID->new;

       class: "APR::UUID" ( "APR::UUID class" )
       ret: $uuid ( "APR::UUID object" )
       since: 2.0.00

   "DESTROY"
	 $uuid->DESTROY;

       obj: "APR::UUID" ( "APR::UUID object" )
       ret: no return value
       since: 2.0.00

       Do not call this method, it's designed to be only called by Perl when the variable goes out of scope. If you call it yourself you will get
       a segfault when perl will call DESTROY on its own.

   "parse"
       Convert a UUID string into an "APR::UUID object" object:

	 $uuid = APR::UUID->parse($uuid_str)

       arg1: $uuid_str (string)
	   UUID string (.e.g 'd48889bb-d11d-b211-8567-ec81968c93c6')

       ret: $uuid ( "APR::UUID object" )
	   The new object.

       since: 2.0.00

See Also
       mod_perl 2.0 documentation.

Copyright
       mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors
       The mod_perl development team and numerous contributors.

perl v5.14.2							    2011-02-08		     libapache2-mod-perl2-2.0.7::docs::api::APR::UUID(3pm)