argra****@users*****
argra****@users*****
2011年 3月 10日 (木) 00:41:07 JST
Index: docs/modules/libwww-perl-5.813/HTML/Form.pod
diff -u docs/modules/libwww-perl-5.813/HTML/Form.pod:1.1 docs/modules/libwww-perl-5.813/HTML/Form.pod:1.2
--- docs/modules/libwww-perl-5.813/HTML/Form.pod:1.1 Thu Oct 21 04:56:20 2010
+++ docs/modules/libwww-perl-5.813/HTML/Form.pod Thu Mar 10 00:41:07 2011
@@ -34,10 +34,11 @@
=end original
-Objects of the C<HTML::Form> class represents a single HTML
-C<E<lt>formE<gt> ... E<lt>/formE<gt>> instance. A form consists of a
-sequence of inputs that usually have names, and which can take on
-various values. The state of a form can be tweaked and it can then be
+C<HTML::Form> クラスのオブジェクトは一つの HTML の
+C<E<lt>formE<gt> ... E<lt>/formE<gt>> 実体を表現します。
+一つのフォームは、普通は名前の付いている、様々な値を取ることができる
+いくつかの入力で構成されます。
+フォームの状態は can be tweaked and it can then be
asked to provide C<HTTP::Request> objects that can be passed to the
request() method of C<LWP::UserAgent>.
(TBT)
@@ -67,10 +68,10 @@
=end original
-The parse() class method will parse an HTML document and build up
-C<HTML::Form> objects for each <form> element found. If called in scalar
-context only returns the first <form>. Returns an empty list if there
-are no forms to be found.
+parse() クラスメソッドは will parse an HTML document and build up
+C<HTML::Form> objects for each <form> element found.
+スカラコンテキストで呼び出すと、最初の <form> だけが返されます。
+フォームが見つからなかった場合は空リストが返されます。
(TBT)
=begin original
@@ -82,11 +83,10 @@
=end original
-The $base is the URI used to retrieve the $html_document. It is
-needed to resolve relative action URIs. If the document was retrieved
-with LWP then this this parameter is obtained from the
-$response->base() method, as shown by the following example:
-(TBT)
+$base は $html_document の取得に使われた URI です。
+これは相対アクション URI を解決するのに必要です。
+LWP を使って文書が取得されると、以下の例のように、
+この引数が $response->base() から取られます:
my $ua = LWP::UserAgent->new;
my $response = $ua->get("http://www.example.com/form.html");
@@ -100,9 +100,8 @@
=end original
-The parse() method can parse from an C<HTTP::Response> object
-directly, so the example above can be more conveniently written as:
-(TBT)
+parse() メソッドは C<HTTP::Response> オブジェクトから直接パースすることも
+できるので、上述の例は以下のようにしてより便利になります:
my $ua = LWP::UserAgent->new;
my $response = $ua->get("http://www.example.com/form.html");
@@ -115,9 +114,9 @@
=end original
-Note that any object that implements a decoded_content() and base() method
-with similar behaviour as C<HTTP::Response> will do.
-(TBT)
+C<HTTP::Response> と同じような振る舞いをする
+decoded_content() メソッドと base() メソッドが実装されているどのような
+オブジェクトでも行えることに注意してください。
=begin original
@@ -126,9 +125,9 @@
=end original
-Finally options might be passed in to control how the parse method
-behaves. The following options are currently recognized:
-(TBT)
+最後に、どのようにパースメソッドが振る舞うかを制御するオプションを
+渡せます。
+現在以下のオプションを認識します:
=over
@@ -140,8 +139,7 @@
=end original
-Another way to provide the base URI.
-(TBT)
+ベース URI を提供するもう一つの方法です。
=item C<verbose>
@@ -151,8 +149,7 @@
=end original
-Print messages to STDERR about any bad HTML form constructs found.
-(TBT)
+悪い HTML フォーム構造を見つけると、STDERR にメッセージを出力します。
=back
@@ -167,9 +164,9 @@
=end original
-This method is gets/sets the I<method> name used for the
-C<HTTP::Request> generated. It is a string like "GET" or "POST".
-(TBT)
+このメソッドは、C<HTTP::Request> が生成されるときに使われる I<メソッド> 名を
+取得/設定します。
+これは "GET" や "POST" のような文字列です。
=item $action = $form->action
@@ -182,9 +179,7 @@
=end original
-This method gets/sets the URI which we want to apply the request
-I<method> to.
-(TBT)
+このメソッドはリクエスト I<メソッド> を適用したい URI を取得/設定します。
=item $enctype = $form->enctype
@@ -197,9 +192,9 @@
=end original
-This method gets/sets the encoding type for the form data. It is a
-string like "application/x-www-form-urlencoded" or "multipart/form-data".
-(TBT)
+このメソッドはフォームデータのエンコーディングタイプを取得/設定します。
+これは "application/x-www-form-urlencoded" や "multipart/form-data" のような
+文字列です。
=item $value = $form->attr( $name )
@@ -212,9 +207,8 @@
=end original
-This method give access to the original HTML attributes of the <form> tag.
-The $name should always be passed in lower case.
-(TBT)
+このメソッドは元の <form> タグの HTML 属性へのアクセスを提供します。
+$name は常に小文字で渡す必要があります。
=begin original
@@ -222,8 +216,7 @@
=end original
-Example:
-(TBT)
+例:
@f = HTML::Form->parse( $html, $foo );
@f = grep $_->attr("id") eq "foo", @f;
@@ -241,11 +234,10 @@
=end original
-This method returns the list of inputs in the form. If called in
-scalar context it returns the number of inputs contained in the form.
-See L</INPUTS> for what methods are available for the input objects
-returned.
-(TBT)
+このメソッドはフォームの入力のリストを返します。
+スカラコンテキストで呼ばれると、フォームに含まれている入力の数を返します。
+返された入力オブジェクトで利用可能なメソッドについては
+L</INPUTS> を参照してください。
=item $input = $form->find_input( $name )
@@ -261,10 +253,10 @@
=end original
-This method is used to locate specific inputs within the form. All
-inputs that match the arguments given are returned. In scalar context
-only the first is returned, or C<undef> if none match.
-(TBT)
+このメソッドはフォーム内の特定の入力の位置を知るために使われます。
+与えられた引数にマッチングする入力全てが返されます。
+スカラコンテキストでは、マッチングしなければ C<undef> を、
+マッチングすれば最初のものだけを返します。
=begin original
@@ -272,8 +264,7 @@
=end original
-If $name is specified, then the input must have the indicated name.
-(TBT)
+$name が指定された場合、入力は指示された名前を持たなければなりません。
=begin original
@@ -283,10 +274,9 @@
=end original
-If $type is specified, then the input must have the specified type.
-The following type names are used: "text", "password", "hidden",
-"textarea", "file", "image", "submit", "radio", "checkbox" and "option".
-(TBT)
+$type が指定された場合、有力は指定された種類でなければなりません。
+以下の種類が使われます: "text", "password", "hidden",
+"textarea", "file", "image", "submit", "radio", "checkbox", "option"
=begin original
@@ -296,10 +286,9 @@
=end original
-The $index is the sequence number of the input matched where 1 is the
-first. If combined with $name and/or $type then it select the I<n>th
-input with the given name and/or type.
-(TBT)
+$index はマッチングする入力のシーケンス番号(1 が先頭)です。
+$name や $type と組み合わせると、与えられた名前や種類の
+I<n> 番目が選択されます。
=item $value = $form->value( $name )
@@ -312,9 +301,8 @@
=end original
-The value() method can be used to get/set the value of some input. If
-no input has the indicated name, then this method will croak.
-(TBT)
+value() メソッドは特定の入力の値を取得/設定するために使われます。
+指定された名前の入力がない場合、このメソッドは croak します。
=begin original
@@ -323,9 +311,7 @@
=end original
-If multiple inputs have the same name, only the first one will be
-affected.
-(TBT)
+同じ名前の入力が複数ある場合、最初のものだけが影響します。
=begin original
@@ -333,8 +319,7 @@
=end original
-The call:
-(TBT)
+以下の呼び出し:
$form->value('foo')
@@ -344,8 +329,7 @@
=end original
-is a short-hand for:
-(TBT)
+は以下のものの短縮形です:
$form->find_input('foo')->value;
@@ -363,8 +347,7 @@
=end original
-Alternative interface to examining and setting the values of the form.
-(TBT)
+フォームの値の調査と設定を行うためのもう一つのインターフェースです。
=begin original
@@ -375,11 +358,9 @@
=end original
-If called without arguments then it returns the names of all the
-inputs in the form. The names will not repeat even if multiple inputs
-have the same name. In scalar context the number of different names
-is returned.
-(TBT)
+引数なしで呼ばれると、フォームの全ての入力の名前を返します。
+同じ名前の入力が複数あっても一度しか現れません。
+スカラコンテキストでは、異なる名前の数が返されます。
=begin original
@@ -642,8 +623,7 @@
=end original
-The following methods are available for the I<input> objects:
-(TBT)
+以下のメソッドが I<input> オブジェクトで利用可能です:
=over 4
@@ -672,8 +652,7 @@
=end original
-This method can be used to get/set the current name of the input.
-(TBT)
+このメソッドは入力の現在の名前を取得/設定できます。
=item $value = $input->value
@@ -686,9 +665,7 @@
=end original
-This method can be used to get/set the current value of an
-input.
-(TBT)
+このメソッドは入力の現在の値を取得/設定できます。
=begin original
@@ -698,10 +675,9 @@
=end original
-If the input only can take an enumerated list of values, then it is an
-error to try to set it to something else and the method will croak if
-you try.
-(TBT)
+入力が列挙された値のリストうちの一つだけを取る場合、違う値を
+設定しようとすることはエラーであり、そうしようとするとメソッドは
+croak します。
=begin original
@@ -710,9 +686,8 @@
=end original
-You will also be able to set the value of read-only inputs, but a
-warning will be generated if running under C<perl -w>.
-(TBT)
+また、読み込み専用入力の値を設定することもできますが、
+C<perl -w> で実行されている場合は警告が発生します。
=item $input->possible_values
@@ -723,9 +698,8 @@
=end original
-Returns a list of all values that an input can take. For inputs that
-do not have discrete values, this returns an empty list.
-(TBT)
+入力が取ることができる全ての値のリストを返します。
+離散値を取る入力でない場合は、空リストを返します。
=item $input->other_possible_values
@@ -735,8 +709,7 @@
=end original
-Returns a list of all values not tried yet.
-(TBT)
+まだ試していない全ての値のリストを返します。
=item $input->value_names
@@ -952,17 +925,9 @@
Copyright 1998-2005 Gisle Aas.
-=begin original
-
This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
-=end original
-
-This library is free software; you can redistribute it and/or
-modify it under the same terms as Perl itself.
-(TBT)
-
=begin meta
Translated: Kentaro SHIRAKATA <argra****@ub32*****> (5.813)