Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
PerlSections	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
Access.pm	14.75 KB	-rw-r--r--	2022-10-20 09:29
Build.pm	61.42 KB	-rw-r--r--	2022-10-20 09:29
BuildConfig.pm	6.81 KB	-rw-r--r--	2022-10-20 09:29
CmdParms.pm	9.93 KB	-rw-r--r--	2022-10-20 09:29
Command.pm	3.41 KB	-rw-r--r--	2022-10-20 09:29
Connection.pm	15.61 KB	-rw-r--r--	2022-10-20 09:29
ConnectionUtil.pm	2.81 KB	-rw-r--r--	2022-10-20 09:29
Const.pm	25.46 KB	-rw-r--r--	2022-10-20 09:29
Directive.pm	7.65 KB	-rw-r--r--	2022-10-20 09:29
Filter.pm	26.79 KB	-rw-r--r--	2022-10-20 09:29
FilterRec.pm	2.17 KB	-rw-r--r--	2022-10-20 09:29
HookRun.pm	13.14 KB	-rw-r--r--	2022-10-20 09:29
Log.pm	18.44 KB	-rw-r--r--	2022-10-20 09:29
MPM.pm	2.75 KB	-rw-r--r--	2022-10-20 09:29
Module.pm	8.13 KB	-rw-r--r--	2022-10-20 09:29
ParseSource.pm	16.72 KB	-rw-r--r--	2022-01-30 13:02
PerlSections.pm	16.89 KB	-rw-r--r--	2022-10-20 09:29
Process.pm	2.46 KB	-rw-r--r--	2022-10-20 09:29
Provider.pm	543 B	-rw-r--r--	2022-10-20 09:29
RequestIO.pm	10.02 KB	-rw-r--r--	2022-10-20 09:29
RequestRec.pm	41.51 KB	-rw-r--r--	2022-10-20 09:29
RequestUtil.pm	27.83 KB	-rw-r--r--	2022-10-20 09:29
Resource.pm	5.72 KB	-rw-r--r--	2022-10-20 09:29
Response.pm	9.85 KB	-rw-r--r--	2022-10-20 09:29
ServerRec.pm	16.63 KB	-rw-r--r--	2022-10-20 09:29
ServerUtil.pm	21.82 KB	-rw-r--r--	2022-10-20 09:29
SizeLimit.pm	16.44 KB	-rw-r--r--	2022-01-30 13:02
SourceTables.pm	1.29 KB	-rw-r--r--	2022-01-30 13:02
Status.pm	29.93 KB	-rw-r--r--	2022-10-20 09:29
SubProcess.pm	6.72 KB	-rw-r--r--	2022-10-20 09:29
SubRequest.pm	10.13 KB	-rw-r--r--	2022-10-20 09:29
URI.pm	6.55 KB	-rw-r--r--	2022-10-20 09:29
Util.pm	3.53 KB	-rw-r--r--	2022-10-20 09:29
XSLoader.pm	1.27 KB	-rw-r--r--	2022-01-30 13:02
compat.pm	26.32 KB	-rw-r--r--	2022-10-20 09:29
porting.pm	6.09 KB	-rw-r--r--	2022-10-20 09:29

Rename

# 
# /*
#  * *********** WARNING **************
#  * This file generated by ModPerl::WrapXS/0.01
#  * Any changes made here will be lost
#  * ***********************************
#  * 01: lib/ModPerl/Code.pm:716
#  * 02: lib/ModPerl/WrapXS.pm:635
#  * 03: lib/ModPerl/WrapXS.pm:1186
#  * 04: Makefile.PL:435
#  * 05: Makefile.PL:333
#  * 06: Makefile.PL:59
#  */
#

package Apache2::Util;

use strict;
use warnings FATAL => 'all';

use Apache2::XSLoader ();
our $VERSION = '2.000012';
Apache2::XSLoader::load __PACKAGE__;

1;
__END__

=head1 NAME

Apache2::Util - Perl API for Misc Apache Utility functions

=head1 Synopsis

use Apache2::Util ();
  
  # OS escape path
  $escaped_path = Apache2::Util::escape_path($path, "a 'long' file.html");
  
  # format time as a string
  my $fmt = "%a, %D %H:%M:%S %Z";
  $fmtdate = Apache2::Util::ht_time($r->pool, $r->request_time, $fmt, 0);

=head1 Description

Various Apache utilities that don't fit into any other group.

=head1 Functions API

C<Apache2::Util> provides the following functions and/or methods:

=head2 C<escape_path>

convert an OS path to a URL in an OS dependent way.

$escaped_path = Apache2::Util::escape_path($path, $p);
  $escaped_path = Apache2::Util::escape_path($path, $p, $partial);

=over 4

=item arg1: C<$path> ( string )

The path to convert

=item arg2: C<$p>
( C<L<APR::Pool|docs::2.0::api::APR::Pool>> )

The pool to allocate from

=item opt arg3: C<$partial> ( boolean )

if TRUE, assume that the path will be appended to something with a '/'
in it (and thus does not prefix "./")

if FALSE it prepends C<"./"> unless C<$path> contains C<:> optionally
followed by C</>.

the default is TRUE

=item ret: C<$escaped_path> ( string )

The escaped path

=item since: 2.0.00

=back

=head2 C<ht_time>

Convert time from an integer value into a string in a specified format

$time_str = Apache2::Util::ht_time($p);
  $time_str = Apache2::Util::ht_time($p, $time);
  $time_str = Apache2::Util::ht_time($p, $time, $fmt);
  $time_str = Apache2::Util::ht_time($p, $time, $fmt, $gmt);

=over 4

=item arg1: C<$p>
( C<L<APR::Pool object|docs::2.0::api::APR::Pool>> )

The pool to allocate memory from

=item opt arg2: C<$time> ( number )

The time to convert (e.g., C<time()> or
C<L<$r-E<gt>request_time|docs::2.0::api::Apache2::RequestRec/C_request_time_>>).

If the value is not passed the current time will be used.

=item opt arg3: C<$fmt> ( string )

The format to use for the conversion, using strftime(3) tokens.

If the value is not passed the default format used is:

"%a, %d %b %Y %H:%M:%S %Z"

=item opt arg4: C<$gmt> ( boolean )

The time will be not converted to GMT if FALSE is passed.

If the value is not passed TRUE (do convert) is used as a default.

=item ret: C<$time_str> (string)

The string that represents the specified time

=item since: 2.0.00

=back

Examples:

Use current time, the default format and convert to GMT:

$fmtdate = Apache2::Util::ht_time($r->pool);

Use my time, the default format and convert to GMT:

my $time = time+100;
  $fmtdate = Apache2::Util::ht_time($r->pool, $time);

Use the time the request has started, custom format and don't convert
to GMT:

my $fmt = "%a, %D %H:%M:%S %Z";
  $fmtdate = Apache2::Util::ht_time($r->pool, $r->request_time, $fmt, 0);

=head1 See Also

L<mod_perl 2.0 documentation|docs::2.0::index>.

=head1 Copyright

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

=head1 Authors

L<The mod_perl development team and numerous
contributors|about::contributors::people>.

=cut