URI-1.54 >
1.35
との差分
URI::Split 1.35 と 1.54 の差分
| 1 | 1 | |
| 2 | 2 | =encoding euc-jp |
| 3 | 3 | |
| 4 | 4 | =head1 NAME |
| 5 | 5 | |
| 6 | 6 | =begin original |
| 7 | 7 | |
| 8 | 8 | URI::Split - Parse and compose URI strings |
| 9 | 9 | |
| 10 | 10 | =end original |
| 11 | 11 | |
| 12 | 12 | URI::Split - URI 文字列をパースおよび構成する |
| 13 | 13 | |
| 14 | 14 | =head1 SYNOPSIS |
| 15 | 15 | |
| 16 | 16 | use URI::Split qw(uri_split uri_join); |
| 17 | 17 | ($scheme, $auth, $path, $query, $frag) = uri_split($uri); |
| 18 | 18 | $uri = uri_join($scheme, $auth, $path, $query, $frag); |
| 19 | 19 | |
| 20 | 20 | =head1 DESCRIPTION |
| 21 | 21 | |
| 22 | 22 | =begin original |
| 23 | 23 | |
| 24 | 24 | Provides functions to parse and compose URI |
| 25 | 25 | strings. The following functions are provided: |
| 26 | 26 | |
| 27 | 27 | =end original |
| 28 | 28 | |
| 29 | ||
| 29 | URI 文字列のパースおよび構成を行う関数を提供します。 | |
| 30 | ||
| 30 | 次の関数が提供されます: | |
| 31 | (TBT) | |
| 32 | 31 | |
| 33 | 32 | =over |
| 34 | 33 | |
| 35 | 34 | =item ($scheme, $auth, $path, $query, $frag) = uri_split($uri) |
| 36 | 35 | |
| 37 | 36 | =begin original |
| 38 | 37 | |
| 39 | 38 | Breaks up a URI string into its component |
| 40 | 39 | parts. An C<undef> value is returned for those parts that are not |
| 41 | 40 | present. The $path part is always present (but can be the empty |
| 42 | 41 | string) and is thus never returned as C<undef>. |
| 43 | 42 | |
| 44 | 43 | =end original |
| 45 | 44 | |
| 46 | ||
| 45 | URI 文字列を構成要素に分解します。 | |
| 47 | ||
| 46 | 要素がない部分に対しては C<undef> が返されます。 | |
| 48 | ||
| 47 | $path 部分は常に存在する (但し空文字列のことはあります) ので、 | |
| 49 | ||
| 48 | C<undef> を返すことはありません。 | |
| 50 | (TBT) | |
| 51 | 49 | |
| 52 | 50 | =begin original |
| 53 | 51 | |
| 54 | 52 | No sensible value is returned if this function is called in a scalar |
| 55 | 53 | context. |
| 56 | 54 | |
| 57 | 55 | =end original |
| 58 | 56 | |
| 59 | ||
| 57 | この関数がスカラコンテキストで呼び出されると、 | |
| 60 | ||
| 58 | 特に意味のある値は返しません。 | |
| 61 | (TBT) | |
| 62 | 59 | |
| 63 | 60 | =item $uri = uri_join($scheme, $auth, $path, $query, $frag) |
| 64 | 61 | |
| 65 | 62 | =begin original |
| 66 | 63 | |
| 67 | 64 | Puts together a URI string from its parts. |
| 68 | 65 | Missing parts are signaled by passing C<undef> for the corresponding |
| 69 | 66 | argument. |
| 70 | 67 | |
| 71 | 68 | =end original |
| 72 | 69 | |
| 73 | ||
| 70 | URI の要素から文字列を作り上げます。 | |
| 74 | ||
| 71 | 存在しない部分に対しては、対応する引数として C<undef> を渡すことで示します。 | |
| 75 | argument. | |
| 76 | (TBT) | |
| 77 | 72 | |
| 78 | 73 | =begin original |
| 79 | 74 | |
| 80 | 75 | Minimal escaping is applied to parts that contain reserved chars |
| 81 | 76 | that would confuse a parser. For instance, any occurrence of '?' or '#' |
| 82 | 77 | in $path is always escaped, as it would otherwise be parsed back |
| 83 | 78 | as a query or fragment. |
| 84 | 79 | |
| 85 | 80 | =end original |
| 86 | 81 | |
| 87 | ||
| 82 | パーサを混乱させる予約文字を含む部分には最小限のエスケープが行われます。 | |
| 88 | ||
| 83 | 例えば、$path にある '?' や '#' は常にエスケープされます; | |
| 89 | ||
| 84 | さもなければクエリやフラグメントとしてパースされるかもしれないからです。 | |
| 90 | as a query or fragment. | |
| 91 | (TBT) | |
| 92 | 85 | |
| 93 | 86 | =back |
| 94 | 87 | |
| 95 | 88 | =head1 SEE ALSO |
| 96 | 89 | |
| 97 | 90 | L<URI>, L<URI::Escape> |
| 98 | 91 | |
| 99 | 92 | =head1 COPYRIGHT |
| 100 | 93 | |
| 101 | 94 | Copyright 2003, Gisle Aas |
| 102 | 95 | |
| 103 | 96 | This library is free software; you can redistribute it and/or |
| 104 | 97 | modify it under the same terms as Perl itself. |
| 105 | 98 | |
| 106 | 99 | =begin meta |
| 107 | 100 | |
| 108 | Translate: SHIRAKATA Kentaro <argrath@ub32.org> (1.35) | |
| 101 | Translate: SHIRAKATA Kentaro <argrath@ub32.org> (1.35-) | |
| 109 | Status: | |
| 102 | Status: completed | |
| 110 | 103 | |
| 111 | 104 | =end meta |
| 112 | 105 | |
| 113 | 106 | =cut |