<h2>Editing File: /usr/share/perl5/URI/_generic.pm</h2><form method='post'><textarea name='content' class='file-edit'>package URI::_generic;

use strict;
use warnings;

use parent qw(URI URI::_query);

use URI::Escape qw(uri_unescape);
use Carp ();

our $VERSION = '1.73';
$VERSION = eval $VERSION;

my $ACHAR = $URI::uric;  $ACHAR =~ s,\\[/?],,g;
my $PCHAR = $URI::uric;  $PCHAR =~ s,\\[?],,g;

sub _no_scheme_ok { 1 }

sub authority
{
    my $self = shift;
    $$self =~ m,^((?:$URI::scheme_re:)?)(?://([^/?\#]*))?(.*)$,os or die;

    if (@_) {
	my $auth = shift;
	$$self = $1;
	my $rest = $3;
	if (defined $auth) {
	    $auth =~ s/([^$ACHAR])/ URI::Escape::escape_char($1)/ego;
	    utf8::downgrade($auth);
	    $$self .= &quot;//$auth&quot;;
	}
	_check_path($rest, $$self);
	$$self .= $rest;
    }
    $2;
}

sub path
{
    my $self = shift;
    $$self =~ m,^((?:[^:/?\#]+:)?(?://[^/?\#]*)?)([^?\#]*)(.*)$,s or die;

    if (@_) {
	$$self = $1;
	my $rest = $3;
	my $new_path = shift;
	$new_path = &quot;&quot; unless defined $new_path;
	$new_path =~ s/([^$PCHAR])/ URI::Escape::escape_char($1)/ego;
	utf8::downgrade($new_path);
	_check_path($new_path, $$self);
	$$self .= $new_path . $rest;
    }
    $2;
}

sub path_query
{
    my $self = shift;
    $$self =~ m,^((?:[^:/?\#]+:)?(?://[^/?\#]*)?)([^\#]*)(.*)$,s or die;

    if (@_) {
	$$self = $1;
	my $rest = $3;
	my $new_path = shift;
	$new_path = &quot;&quot; unless defined $new_path;
	$new_path =~ s/([^$URI::uric])/ URI::Escape::escape_char($1)/ego;
	utf8::downgrade($new_path);
	_check_path($new_path, $$self);
	$$self .= $new_path . $rest;
    }
    $2;
}

sub _check_path
{
    my($path, $pre) = @_;
    my $prefix;
    if ($pre =~ m,/,) {  # authority present
	$prefix = &quot;/&quot; if length($path) &amp;&amp; $path !~ m,^[/?\#],;
    }
    else {
	if ($path =~ m,^//,) {
	    Carp::carp(&quot;Path starting with double slash is confusing&quot;)
		if $^W;
	}
	elsif (!length($pre) &amp;&amp; $path =~ m,^[^:/?\#]+:,) {
	    Carp::carp(&quot;Path might look like scheme, './' prepended&quot;)
		if $^W;
	    $prefix = &quot;./&quot;;
	}
    }
    substr($_[0], 0, 0) = $prefix if defined $prefix;
}

sub path_segments
{
    my $self = shift;
    my $path = $self-&gt;path;
    if (@_) {
	my @arg = @_;  # make a copy
	for (@arg) {
	    if (ref($_)) {
		my @seg = @$_;
		$seg[0] =~ s/%/%25/g;
		for (@seg) { s/;/%3B/g; }
		$_ = join(&quot;;&quot;, @seg);
	    }
	    else {
		 s/%/%25/g; s/;/%3B/g;
	    }
	    s,/,%2F,g;
	}
	$self-&gt;path(join(&quot;/&quot;, @arg));
    }
    return $path unless wantarray;
    map {/;/ ? $self-&gt;_split_segment($_)
             : uri_unescape($_) }
        split('/', $path, -1);
}


sub _split_segment
{
    my $self = shift;
    require URI::_segment;
    URI::_segment-&gt;new(@_);
}


sub abs
{
    my $self = shift;
    my $base = shift || Carp::croak(&quot;Missing base argument&quot;);

    if (my $scheme = $self-&gt;scheme) {
	return $self unless $URI::ABS_ALLOW_RELATIVE_SCHEME;
	$base = URI-&gt;new($base) unless ref $base;
	return $self unless $scheme eq $base-&gt;scheme;
    }

    $base = URI-&gt;new($base) unless ref $base;
    my $abs = $self-&gt;clone;
    $abs-&gt;scheme($base-&gt;scheme);
    return $abs if $$self =~ m,^(?:$URI::scheme_re:)?//,o;
    $abs-&gt;authority($base-&gt;authority);

    my $path = $self-&gt;path;
    return $abs if $path =~ m,^/,;

    if (!length($path)) {
	my $abs = $base-&gt;clone;
	my $query = $self-&gt;query;
	$abs-&gt;query($query) if defined $query;
	my $fragment = $self-&gt;fragment;
	$abs-&gt;fragment($fragment) if defined $fragment;
	return $abs;
    }

    my $p = $base-&gt;path;
    $p =~ s,[^/]+$,,;
    $p .= $path;
    my @p = split('/', $p, -1);
    shift(@p) if @p &amp;&amp; !length($p[0]);
    my $i = 1;
    while ($i &lt; @p) {
	#print &quot;$i &quot;, join(&quot;/&quot;, @p), &quot; ($p[$i])\n&quot;;
	if ($p[$i-1] eq &quot;.&quot;) {
	    splice(@p, $i-1, 1);
	    $i-- if $i &gt; 1;
	}
	elsif ($p[$i] eq &quot;..&quot; &amp;&amp; $p[$i-1] ne &quot;..&quot;) {
	    splice(@p, $i-1, 2);
	    if ($i &gt; 1) {
		$i--;
		push(@p, &quot;&quot;) if $i == @p;
	    }
	}
	else {
	    $i++;
	}
    }
    $p[-1] = &quot;&quot; if @p &amp;&amp; $p[-1] eq &quot;.&quot;;  # trailing &quot;/.&quot;
    if ($URI::ABS_REMOTE_LEADING_DOTS) {
        shift @p while @p &amp;&amp; $p[0] =~ /^\.\.?$/;
    }
    $abs-&gt;path(&quot;/&quot; . join(&quot;/&quot;, @p));
    $abs;
}

# The opposite of $url-&gt;abs.  Return a URI which is as relative as possible
sub rel {
    my $self = shift;
    my $base = shift || Carp::croak(&quot;Missing base argument&quot;);
    my $rel = $self-&gt;clone;
    $base = URI-&gt;new($base) unless ref $base;

    #my($scheme, $auth, $path) = @{$rel}{qw(scheme authority path)};
    my $scheme = $rel-&gt;scheme;
    my $auth   = $rel-&gt;canonical-&gt;authority;
    my $path   = $rel-&gt;path;

    if (!defined($scheme) &amp;&amp; !defined($auth)) {
	# it is already relative
	return $rel;
    }

    #my($bscheme, $bauth, $bpath) = @{$base}{qw(scheme authority path)};
    my $bscheme = $base-&gt;scheme;
    my $bauth   = $base-&gt;canonical-&gt;authority;
    my $bpath   = $base-&gt;path;

    for ($bscheme, $bauth, $auth) {
	$_ = '' unless defined
    }

    unless ($scheme eq $bscheme &amp;&amp; $auth eq $bauth) {
	# different location, can't make it relative
	return $rel;
    }

    for ($path, $bpath) {  $_ = &quot;/$_&quot; unless m,^/,; }

    # Make it relative by eliminating scheme and authority
    $rel-&gt;scheme(undef);
    $rel-&gt;authority(undef);

    # This loop is based on code from Nicolai Langfeldt &lt;janl@ifi.uio.no&gt;.
    # First we calculate common initial path components length ($li).
    my $li = 1;
    while (1) {
	my $i = index($path, '/', $li);
	last if $i &lt; 0 ||
                $i != index($bpath, '/', $li) ||
	        substr($path,$li,$i-$li) ne substr($bpath,$li,$i-$li);
	$li=$i+1;
    }
    # then we nuke it from both paths
    substr($path, 0,$li) = '';
    substr($bpath,0,$li) = '';

    if ($path eq $bpath &amp;&amp;
        defined($rel-&gt;fragment) &amp;&amp;
        !defined($rel-&gt;query)) {
        $rel-&gt;path(&quot;&quot;);
    }
    else {
        # Add one &quot;../&quot; for each path component left in the base path
        $path = ('../' x $bpath =~ tr|/|/|) . $path;
	$path = &quot;./&quot; if $path eq &quot;&quot;;
        $rel-&gt;path($path);
    }

    $rel;
}

1;
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Fshare%2Fperl5%2FURI'>Back to Directory</a>