argra****@users*****
argra****@users*****
2017年 3月 28日 (火) 21:45:20 JST
Index: docs/perl/5.22.1/perlsyn.pod
diff -u /dev/null docs/perl/5.22.1/perlsyn.pod:1.1
--- /dev/null Tue Mar 28 21:45:20 2017
+++ docs/perl/5.22.1/perlsyn.pod Tue Mar 28 21:45:20 2017
@@ -0,0 +1,2667 @@
+
+=encoding euc-jp
+
+=head1 NAME
+X<syntax>
+
+=begin original
+
+perlsyn - Perl syntax
+
+=end original
+
+perlsyn - Perl の文法
+
+=head1 DESCRIPTION
+
+=begin original
+
+A Perl program consists of a sequence of declarations and statements
+which run from the top to the bottom. Loops, subroutines, and other
+control structures allow you to jump around within the code.
+
+=end original
+
+Perl プログラムは、宣言と文の並びから構成され、上から下へと実行されます。
+ループ、サブルーチン、その他の制御機構でコードの色々なところに
+ジャンプできます。
+
+=begin original
+
+Perl is a B<free-form> language: you can format and indent it however
+you like. Whitespace serves mostly to separate tokens, unlike
+languages like Python where it is an important part of the syntax,
+or Fortran where it is immaterial.
+
+=end original
+
+Perl は B<自由書式> 言語です: 好きなように整形したりインデントしたり
+できます。
+空白が文法の重要な要素である Python や、意味のない Fortran のような言語と
+異なり、空白はほとんどトークンの分割の役目です。
+
+=begin original
+
+Many of Perl's syntactic elements are B<optional>. Rather than
+requiring you to put parentheses around every function call and
+declare every variable, you can often leave such explicit elements off
+and Perl will figure out what you meant. This is known as B<Do What I
+Mean>, abbreviated B<DWIM>. It allows programmers to be B<lazy> and to
+code in a style with which they are comfortable.
+
+=end original
+
+Perl の多くの文法要素は B<省略可能> です。
+全ての関数をかっこで括ったり、全ての変数を宣言したりすることを
+要求するのではなく、しばしばそのような明示的な要素を置いておいて、
+Perl にあなたが意味しているところを見つけ出させることができます。
+これは B<Do What I Mean> と知られ、頭文字を取って B<DWIM> と呼ばれます。
+これによって、プログラマを B<怠惰> にでき、彼らが快適だと思うスタイルで
+コーディングできるようにします。
+
+=begin original
+
+Perl B<borrows syntax> and concepts from many languages: awk, sed, C,
+Bourne Shell, Smalltalk, Lisp and even English. Other
+languages have borrowed syntax from Perl, particularly its regular
+expression extensions. So if you have programmed in another language
+you will see familiar pieces in Perl. They often work the same, but
+see L<perltrap> for information about how they differ.
+
+=end original
+
+Perl は、awk, sed, C, Bourne Shell, Smalltalk, Lisp, 果ては英語といった、
+多くの言語からコンセプトと B<文法を借用> しています。
+他の言語も Perl から文法を借用しています; 特に正規表現拡張をです。
+従って、他の言語でプログラミングしていたなら、Perl にも見たことがあるような
+ものがあるでしょう。
+それらはしばしば同じように動作しますが、違う点についての情報は
+L<perltrap> を参照してください。
+
+=head2 Declarations
+X<declaration> X<undef> X<undefined> X<uninitialized>
+
+(宣言)
+
+=begin original
+
+The only things you need to declare in Perl are report formats and
+subroutines (and sometimes not even subroutines). A scalar variable holds
+the undefined value (C<undef>) until it has been assigned a defined
+value, which is anything other than C<undef>. When used as a number,
+C<undef> is treated as C<0>; when used as a string, it is treated as
+the empty string, C<"">; and when used as a reference that isn't being
+assigned to, it is treated as an error. If you enable warnings,
+you'll be notified of an uninitialized value whenever you treat
+C<undef> as a string or a number. Well, usually. Boolean contexts,
+such as:
+
+=end original
+
+Perl で宣言が必要なものはレポートフォーマットとサブルーチンだけです
+(サブルーチンすら宣言が不要な場合もあります)。
+スカラ変数は、C<undef> 以外の定義された値を代入されるまでは未定義値
+(C<undef>)となります。
+数値として使われる場合、C<undef> は C<0> として扱われます;
+文字列として使われる場合、これは空文字列 C<""> として扱われます;
+リファレンスとして使われる場合、これは何も代入されていないので、エラーとして
+扱われます。
+警告を有効にしているなら、C<undef> を文字列や数値として扱おうとすると
+未初期価値を指摘されます。
+ええ、普通は。
+次のような真偽値コンテキストなら:
+
+ if ($a) {}
+
+=begin original
+
+are exempt from warnings (because they care about truth rather than
+definedness). Operators such as C<++>, C<-->, C<+=>,
+C<-=>, and C<.=>, that operate on undefined variables such as:
+
+=end original
+
+(定義済みかどうかではなく、真かどうかを考慮するので)警告から免れます。
+未定義の変数を操作する、C<++>, C<-->, C<+=>, C<-=>, C<.=> のような
+演算子でも:
+
+ undef $a;
+ $a++;
+
+=begin original
+
+are also always exempt from such warnings.
+
+=end original
+
+とすることでもそのような警告から免れます。
+
+=begin original
+
+A declaration can be put anywhere a statement can, but has no effect on
+the execution of the primary sequence of statements: declarations all
+take effect at compile time. All declarations are typically put at
+the beginning or the end of the script. However, if you're using
+lexically-scoped private variables created with C<my()>,
+C<state()>, or C<our()>, you'll have to make sure
+your format or subroutine definition is within the same block scope
+as the my if you expect to be able to access those private variables.
+
+=end original
+
+宣言は、文が置けるところであればどこにでも置くことができますが、
+基本的な文の並びは実行時には何の効果も持ちません: 宣言はコンパイル時に
+すべての効果が表れます。
+典型的にはすべての宣言は、スクリプトの先頭か終端に置かれます。
+しかしながら、局所変数を C<my()>,C<state()>, or C<our()> を使って作成して
+レキシカルなスコープを使っているのであれば、フォーマットやサブルーチンの
+定義を、同じブロックのスコープの中でその局所変数にアクセスすることが
+可能であるようにしておく必要があるでしょう。
+
+=begin original
+
+Declaring a subroutine allows a subroutine name to be used as if it were a
+list operator from that point forward in the program. You can declare a
+subroutine without defining it by saying C<sub name>, thus:
+X<subroutine, declaration>
+
+=end original
+
+サブルーチンの宣言は、プログラムの後のほうにあるサブルーチン名を
+リスト演算子のように使うことを許します。
+定義されていないサブルーチンの宣言を、C<sub name> と記述することで
+宣言できるので、以下のようにできます:
+X<subroutine, declaration>
+
+ sub myname;
+ $me = myname $0 or die "can't get myname";
+
+=begin original
+
+A bare declaration like that declares the function to be a list operator,
+not a unary operator, so you have to be careful to use parentheses (or
+C<or> instead of C<||>.) The C<||> operator binds too tightly to use after
+list operators; it becomes part of the last element. You can always use
+parentheses around the list operators arguments to turn the list operator
+back into something that behaves more like a function call. Alternatively,
+you can use the prototype C<($)> to turn the subroutine into a unary
+operator:
+
+=end original
+
+関数の宣言のような裸の宣言はリスト演算子のように働くのであり、
+単項演算子としてではありません; ですから、かっこ (または C<||> の代わりに
+C<or>) を使うことには注意してください。
+C<||> 演算子はリスト演算子の後ろに使うには束縛が強すぎます; 最後の要素の
+一部になります。
+リスト演算子の周りをかっこで囲むことでいつでもリスト演算子を
+関数呼び出しのように振る舞わせるようにできます。
+あるいは、サブルーチンを単項演算子に変えるためにプロトタイプ
+C<($)> も使えます:
+
+ sub myname ($);
+ $me = myname $0 || die "can't get myname";
+
+=begin original
+
+That now parses as you'd expect, but you still ought to get in the habit of
+using parentheses in that situation. For more on prototypes, see
+L<perlsub>.
+
+=end original
+
+これは予想した通りにパースしますが、それでもこのような場合にはかっこを使う
+習慣を付けるべきです。
+プロトタイプに関してさらなる情報は、L<perlsub> を参照してください。
+
+=begin original
+
+Subroutines declarations can also be loaded up with the C<require> statement
+or both loaded and imported into your namespace with a C<use> statement.
+See L<perlmod> for details on this.
+
+=end original
+
+サブルーチンの宣言は C<require> 文を使って詰め込むこともできますし、
+C<use> 文を使って自分の名前空間にロードしたりインポートしたりすることが
+できます。
+これに関する詳細は L<perlmod> を参照してください。
+
+=begin original
+
+A statement sequence may contain declarations of lexically-scoped
+variables, but apart from declaring a variable name, the declaration acts
+like an ordinary statement, and is elaborated within the sequence of
+statements as if it were an ordinary statement. That means it actually
+has both compile-time and run-time effects.
+
+=end original
+
+文の並びはレキシカルスコープを持った変数の宣言を含むことができますが、
+変数名の宣言とは切り離され、その宣言は通常の文のように振る舞い、
+それが通常の文であるかのように文の並びに組みこまれます。
+これは、そういった宣言がコンパイル時の効果と実行時の効果の両方を
+持っているということです。
+
+=head2 Comments
+X<comment> X<#>
+
+(コメント)
+
+=begin original
+
+Text from a C<"#"> character until the end of the line is a comment,
+and is ignored. Exceptions include C<"#"> inside a string or regular
+expression.
+
+=end original
+
+コメントは C<“#”> 文字から、行末まで続き、その部分は無視されます。
+例外は、文字列や正規表現の中にある C<"#"> です。
+
+=head2 Simple Statements
+X<statement> X<semicolon> X<expression> X<;>
+
+(単純文)
+
+=begin original
+
+The only kind of simple statement is an expression evaluated for its
+side-effects. Every simple statement must be terminated with a
+semicolon, unless it is the final statement in a block, in which case
+the semicolon is optional. But put the semicolon in anyway if the
+block takes up more than one line, because you may eventually add
+another line. Note that there are operators like C<eval {}>, C<sub {}>, and
+C<do {}> that I<look> like compound statements, but aren't--they're just
+TERMs in an expression--and thus need an explicit termination when used
+as the last item in a statement.
+
+=end original
+
+単純文となる唯一の種類は、その副作用のために評価される式です。
+すべての単純文は、それがセミコロンを省略することのできるブロックの
+最後にない限りは文を終端するためのセミコロンがなければなりません。
+ブロックが二行以上に渡る場合には、とにかくセミコロンを付けてください;
+なぜなら、別の行を追加する可能性があるからです。
+C<eval {}>, C<sub {}>, C<do {}> のように、一見複合文のように I<見える> けれども
+そうではない--これらは単なる式における TERM です--ものがあって、
+そういったものを文の最後のアイテムとして使った場合には明示的に終端する
+必要があるのだということに注意してください。
+
+=head2 Truth and Falsehood
+X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0>
+
+(真偽値)
+
+=begin original
+
+The number 0, the strings C<'0'> and C<"">, the empty list C<()>, and
+C<undef> are all false in a boolean context. All other values are true.
+Negation of a true value by C<!> or C<not> returns a special false value.
+When evaluated as a string it is treated as C<"">, but as a number, it
+is treated as 0. Most Perl operators
+that return true or false behave this way.
+
+=end original
+
+数値 0, 文字列 C<'0'> と C<"">, 空リスト C<()>, C<undef> は全て真偽値
+コンテキストでは偽となります。
+その他の全ての値は真です。
+真の値を C<!> や C<not> で否定すると、特殊な偽の値を返します。
+これを文字列として評価すると C<""> として扱われますが、数値として評価すると
+0 として扱われます。
+真または偽を返す、ほとんど Perl の演算子はこのように振る舞います。
+
+=head2 Statement Modifiers
+X<statement modifier> X<modifier> X<if> X<unless> X<while>
+X<until> X<when> X<foreach> X<for>
+
+(文修飾子)
+
+=begin original
+
+Any simple statement may optionally be followed by a I<SINGLE> modifier,
+just before the terminating semicolon (or block ending). The possible
+modifiers are:
+
+=end original
+
+任意の単純文には、B<一つ> の修飾子を終端のセミコロンの直前(もしくは
+ブロックの終端の直前)に付けることができます。
+使うことのできる修飾子は以下の通りです。
+
+ if EXPR
+ unless EXPR
+ while EXPR
+ until EXPR
+ for LIST
+ foreach LIST
+ when EXPR
+
+=begin original
+
+The C<EXPR> following the modifier is referred to as the "condition".
+Its truth or falsehood determines how the modifier will behave.
+
+=end original
+
+修飾子に引き続く C<EXPR> は「条件」として参照されます。
+その真偽値が修飾子の振る舞いを決定します。
+
+=begin original
+
+C<if> executes the statement once I<if> and only if the condition is
+true. C<unless> is the opposite, it executes the statement I<unless>
+the condition is true (that is, if the condition is false).
+
+=end original
+
+C<if> は I<もし> 条件が真の場合にのみ文を実行します。
+C<unless> は逆で、条件が真 I<でない限り> (つまり、条件が偽なら) 文を
+実行します。
+
+ print "Basset hounds got long ears" if length $ear >= 10;
+ go_outside() and play() unless $is_raining;
+
+=begin original
+
+The C<for(each)> modifier is an iterator: it executes the statement once
+for each item in the LIST (with C<$_> aliased to each item in turn).
+
+=end original
+
+C<for(each)> 修飾子は反復子です:
+LIST の値それぞれ毎に文を実行します(実行中は C<$_> がそれぞれの値の
+エイリアスとなります)。
+
+ print "Hello $_!\n" for qw(world Dolly nurse);
+
+=begin original
+
+C<while> repeats the statement I<while> the condition is true.
+C<until> does the opposite, it repeats the statement I<until> the
+condition is true (or while the condition is false):
+
+=end original
+
+C<while> は条件が真 I<の間> 文を繰り返します。
+C<until> は逆で、条件が真 I<になるまで> (つまり条件が偽の間) 文を
+繰り返します:
+
+ # Both of these count from 0 to 10.
+ print $i++ while $i <= 10;
+ print $j++ until $j > 10;
+
+=begin original
+
+The C<while> and C<until> modifiers have the usual "C<while> loop"
+semantics (conditional evaluated first), except when applied to a
+C<do>-BLOCK (or to the Perl4 C<do>-SUBROUTINE statement), in
+which case the block executes once before the conditional is
+evaluated.
+
+=end original
+
+修飾子 C<while> と C<until> は、一般的な "C<while> loop" の意味を
+持っています(条件が最初に評価される)が、C<do>-ブロック(もしくは Perl4 の
+C<do>-サブルーチン文)に適用されるときは例外で、
+このときは条件が評価されるよりも前に、一度ブロックが実行されます。
+
+=begin original
+
+This is so that you can write loops like:
+
+=end original
+
+このため、次のようなループを記述することができます:
+
+ do {
+ $line = <STDIN>;
+ ...
+ } until !defined($line) || $line eq ".\n"
+
+=begin original
+
+See L<perlfunc/do>. Note also that the loop control statements described
+later will I<NOT> work in this construct, because modifiers don't take
+loop labels. Sorry. You can always put another block inside of it
+(for C<next>) or around it (for C<last>) to do that sort of thing.
+For C<next>, just double the braces:
+X<next> X<last> X<redo>
+
+=end original
+
+L<perlfunc/do> を参照してください。
+後述するループの制御文は、修飾子がループラベルを取らないために
+この構造文では I<動作しない> ということにも注意してください。
+申し訳ない。
+こういった場合に対処するのに別のブロックを内側に入れたり(C<next> の場合)、
+別のブロックで囲む(C<last> の場合)という方法が常に使えます。
+C<next> では単に中かっこを二重にします:
+X<next> X<last> X<redo>
+
+ do {{
+ next if $x == $y;
+ # do something here
+ }} until $x++ > $z;
+
+=begin original
+
+For C<last>, you have to be more elaborate:
+X<last>
+
+=end original
+
+C<last> の場合は、もっと念入りにする必要があります:
+
+ LOOP: {
+ do {
+ last if $x = $y**2;
+ # do something here
+ } while $x++ <= $z;
+ }
+
+=begin original
+
+B<NOTE:> The behaviour of a C<my>, C<state>, or
+C<our> modified with a statement modifier conditional
+or loop construct (for example, C<my $x if ...>) is
+B<undefined>. The value of the C<my> variable may be C<undef>, any
+previously assigned value, or possibly anything else. Don't rely on
+it. Future versions of perl might do something different from the
+version of perl you try it out on. Here be dragons.
+X<my>
+
+=end original
+
+B<注意:> (C<my $x if ...> のような) 条件構造やループ構造で修飾された
+C<my> C<state>,C<our> 文の振る舞いは B<未定義> です。
+C<my> 変数の値は C<undef> かも知れませんし、以前に代入された値かも
+知れませんし、その他の如何なる値の可能性もあります。
+この値に依存してはいけません。
+perl の将来のバージョンでは現在のバージョンとは何か違うかも知れません。
+ここには厄介なものがいます。
+X<my>
+
+=begin original
+
+The C<when> modifier is an experimental feature that first appeared in Perl
+5.14. To use it, you should include a C<use v5.14> declaration.
+(Technically, it requires only the C<switch> feature, but that aspect of it
+was not available before 5.14.) Operative only from within a C<foreach>
+loop or a C<given> block, it executes the statement only if the smartmatch
+C<< $_ ~~ I<EXPR> >> is true. If the statement executes, it is followed by
+a C<next> from inside a C<foreach> and C<break> from inside a C<given>.
+
+=end original
+
+C<when> 修飾子は Perl 5.14 で最初に現れた実験的機能です。
+使うには、C<use v5.14> 宣言を含めます。
+(技術的には、C<switch> 機能だけが必要ですが、この観点では 5.14 より前では
+利用できません。)
+C<foreach> ループか C<given> ブロックの内側でのみ動作可能で、
+スマートマッチング C<< $_ ~~ I<EXPR> >> が真の場合にのみ実行されます。
+文が実行されると、C<foreach> の内側からは C<next> に、C<given> の
+内側からは C<break> に引き続きます。
+
+=begin original
+
+Under the current implementation, the C<foreach> loop can be
+anywhere within the C<when> modifier's dynamic scope, but must be
+within the C<given> block's lexical scope. This restricted may
+be relaxed in a future release. See L<"Switch Statements"> below.
+
+=end original
+
+現在の実装では、C<foreach> ループは C<when> 修飾子の動的スコープの内側の
+どこでも使えますが、C<given> ブロックのレキシカルスコープの内側で
+なければなりません。
+この制限は将来のリリースで緩和されるかもしれません。
+後述する L<"Switch Statements"> を参照してください。
+
+=head2 Compound Statements
+X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace>
+X<{> X<}> X<if> X<unless> X<given> X<while> X<until> X<foreach> X<for> X<continue>
+
+(複合文)
+
+=begin original
+
+In Perl, a sequence of statements that defines a scope is called a block.
+Sometimes a block is delimited by the file containing it (in the case
+of a required file, or the program as a whole), and sometimes a block
+is delimited by the extent of a string (in the case of an eval).
+
+=end original
+
+Perl では、スコープを定義するような文の並びをブロックと呼びます。
+ブロックはそれを含むファイルによって範囲が定められることがあります
+(ファイルが require されたときか、プログラム全体としての場合)し、
+文字列の展開によって範囲が定められる(eval の場合)こともあります。
+
+=begin original
+
+But generally, a block is delimited by curly brackets, also known as braces.
+We will call this syntactic construct a BLOCK.
+
+=end original
+
+しかし一般的には、ブロックは中かっこによって範囲が定められます。
+この構文的な構造をブロックと呼びます。
+
+=begin original
+
+The following compound statements may be used to control flow:
+
+=end original
+
+以下に挙げる複合文を制御フローとして使うことができます:
+
+ if (EXPR) BLOCK
+ if (EXPR) BLOCK else BLOCK
+ if (EXPR) BLOCK elsif (EXPR) BLOCK ...
+ if (EXPR) BLOCK elsif (EXPR) BLOCK ... else BLOCK
+
+ unless (EXPR) BLOCK
+ unless (EXPR) BLOCK else BLOCK
+ unless (EXPR) BLOCK elsif (EXPR) BLOCK ...
+ unless (EXPR) BLOCK elsif (EXPR) BLOCK ... else BLOCK
+
+ given (EXPR) BLOCK
+
+ LABEL while (EXPR) BLOCK
+ LABEL while (EXPR) BLOCK continue BLOCK
+
+ LABEL until (EXPR) BLOCK
+ LABEL until (EXPR) BLOCK continue BLOCK
+
+ LABEL for (EXPR; EXPR; EXPR) BLOCK
+ LABEL for VAR (LIST) BLOCK
+ LABEL for VAR (LIST) BLOCK continue BLOCK
+
+ LABEL foreach (EXPR; EXPR; EXPR) BLOCK
+ LABEL foreach VAR (LIST) BLOCK
+ LABEL foreach VAR (LIST) BLOCK continue BLOCK
+
+ LABEL BLOCK
+ LABEL BLOCK continue BLOCK
+
+ PHASE BLOCK
+
+=begin original
+
+The experimental C<given> statement is I<not automatically enabled>; see
+L</"Switch Statements"> below for how to do so, and the attendant caveats.
+
+=end original
+
+実験的な C<given> 文は I<自動的に有効にはなりません>; その方法と、それに
+伴う注意点については後述する L</"Switch Statements"> を参照してください。
+
+=begin original
+
+Unlike in C and Pascal, in Perl these are all defined in terms of BLOCKs,
+not statements. This means that the curly brackets are I<required>--no
+dangling statements allowed. If you want to write conditionals without
+curly brackets, there are several other ways to do it. The following
+all do the same thing:
+
+=end original
+
+C や Pascal とは異なり、Perl ではブロックを取るように
+定義されていて文を取るのではありません。
+つまり、中かっこは I<必要なもの> です -- 曖昧な文が許されません。
+中かっこなしの条件文を使いたいのであれば、いくつかのやり方があります。
+以下の全ては同じことです:
+
+ if (!open(FOO)) { die "Can't open $FOO: $!" }
+ die "Can't open $FOO: $!" unless open(FOO);
+ open(FOO) || die "Can't open $FOO: $!";
+ open(FOO) ? () : die "Can't open $FOO: $!";
+ # a bit exotic, that last one
+
+=begin original
+
+The C<if> statement is straightforward. Because BLOCKs are always
+bounded by curly brackets, there is never any ambiguity about which
+C<if> an C<else> goes with. If you use C<unless> in place of C<if>,
+the sense of the test is reversed. Like C<if>, C<unless> can be followed
+by C<else>. C<unless> can even be followed by one or more C<elsif>
+statements, though you may want to think twice before using that particular
+language construct, as everyone reading your code will have to think at least
+twice before they can understand what's going on.
+
+=end original
+
+C<if> 文は明解です。
+ブロックは常に中かっこで区切られるので、C<if> と C<else> の対応が
+曖昧になるようなことは決してありません。
+C<unless> を C<if> の代わりに使うと、検査を反転します。
+C<if> と同様、C<unless> は C<else> に引き続くことができます。
+C<unless> は一つまたはそれ以上の C<elsif> に引き続くことすらできますが、
+この特定の言語構文を使う前に二倍考えたいでしょう; あなたのコードを読む
+誰もが何が行われているのかを理解する前に少なくとも二倍考える必要が
+あるからです。
+
+=begin original
+
+The C<while> statement executes the block as long as the expression is
+L<true|/"Truth and Falsehood">.
+The C<until> statement executes the block as long as the expression is
+false.
+The LABEL is optional, and if present, consists of an identifier followed
+by a colon. The LABEL identifies the loop for the loop control
+statements C<next>, C<last>, and C<redo>.
+If the LABEL is omitted, the loop control statement
+refers to the innermost enclosing loop. This may include dynamically
+looking back your call-stack at run time to find the LABEL. Such
+desperate behavior triggers a warning if you use the C<use warnings>
+pragma or the B<-w> flag.
+
+=end original
+
+C<while> 文は、式が L<真|/"Truth and Falsehood"> である間、ブロックを
+実行します。
+C<until> 文は、式が偽である間、ブロックを実行します。
+LABEL は省略可能ですが、ある場合には、コロンを伴った識別子になります。
+LABEL は C<next>、C<last>、C<redo> といったループ制御文のループを規定します。
+LABEL が省略された場合、ループ制御文はそれを含むループの中で最も内側の
+ループを参照します。
+これは、実行時に LABEL を検出するための呼び出しスタックの動的な後戻り検索を
+含むことができます。
+そのような推奨されない振る舞いは、C<use warnings> プラグマや B<-w> フラグを
+使った場合には警告を引き起こします。
+
+=begin original
+
+If there is a C<continue> BLOCK, it is always executed just before the
+conditional is about to be evaluated again. Thus it can be used to
+increment a loop variable, even when the loop has been continued via
+the C<next> statement.
+
+=end original
+
+C<continue> ブロックが存在する場合、
+常に条件が再評価される直前に実行されます。
+したがって、このブロックをループ変数のインクリメントのために
+使うことができます;
+これは、ループがC<next>文を通して継続されるときでも実行されます。
+
+=begin original
+
+When a block is preceding by a compilation phase keyword such as C<BEGIN>,
+C<END>, C<INIT>, C<CHECK>, or C<UNITCHECK>, then the block will run only
+during the corresponding phase of execution. See L<perlmod> for more details.
+
+=end original
+
+ブロックの前に C<BEGIN>, C<END>, C<INIT>, C<CHECK>, C<UNITCHECK> のような
+コンパイルフェーズキーワードが前置されると、ブロックは対応する実行フェーズの
+間にだけ実行されます。
+さらなる詳細については L<perlmod> を参照してください。
+
+=begin original
+
+Extension modules can also hook into the Perl parser to define new
+kinds of compound statements. These are introduced by a keyword which
+the extension recognizes, and the syntax following the keyword is
+defined entirely by the extension. If you are an implementor, see
+L<perlapi/PL_keyword_plugin> for the mechanism. If you are using such
+a module, see the module's documentation for details of the syntax that
+it defines.
+
+=end original
+
+エクステンションモジュールは新しい種類の複合文を定義するために
+Perl パーサをフックできます。
+これらはエクステンションが認識するキーワードで導入され、キーワードに
+引き続く文法は完全にエクステンションで定義されます。
+もしあなたが実装車なら、仕組みについては L<perlapi/PL_keyword_plugin> を
+参照してください。
+あなたがそのようなモジュールを使うなら、定義されている文法の詳細については
+そのモジュールの文書を参照してください。
+
+=head2 Loop Control
+X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
+
+(ループ制御)
+
+=begin original
+
+The C<next> command starts the next iteration of the loop:
+
+=end original
+
+C<next> コマンドはループの次の繰り返しを開始します:
+
+ LINE: while (<STDIN>) {
+ next LINE if /^#/; # discard comments
+ ...
+ }
+
+=begin original
+
+The C<last> command immediately exits the loop in question. The
+C<continue> block, if any, is not executed:
+
+=end original
+
+C<last> コマンドはループから即座に脱出します。
+C<continue> ブロックがあっても、それは実行されません:
+
+ LINE: while (<STDIN>) {
+ last LINE if /^$/; # exit when done with header
+ ...
+ }
+
+=begin original
+
+The C<redo> command restarts the loop block without evaluating the
+conditional again. The C<continue> block, if any, is I<not> executed.
+This command is normally used by programs that want to lie to themselves
+about what was just input.
+
+=end original
+
+C<redo> コマンドは、条件の再評価をすることなしにループブロックの
+再実行を行います。
+C<continue> ブロックがあっても、それは I<実行されません>。
+このコマンドは通常、プログラムに対する入力に関してプログラム自身を
+だましたいといったときに使われます。
+
+=begin original
+
+For example, when processing a file like F</etc/termcap>.
+If your input lines might end in backslashes to indicate continuation, you
+want to skip ahead and get the next record.
+
+=end original
+
+たとえば、F</etc/termcap> のようなファイルを処理することを
+考えてみましょう。
+もし入力された行の行末が継続を示すバックスラッシュであった場合、先へ進んで
+次のレコードを取り出したいと思うでしょう。
+
+ while (<>) {
+ chomp;
+ if (s/\\$//) {
+ $_ .= <>;
+ redo unless eof();
+ }
+ # now process $_
+ }
+
+=begin original
+
+which is Perl shorthand for the more explicitly written version:
+
+=end original
+
+これは Perl の省略記法で、もっとはっきりと書くと以下のようになります:
+
+ LINE: while (defined($line = <ARGV>)) {
+ chomp($line);
+ if ($line =~ s/\\$//) {
+ $line .= <ARGV>;
+ redo LINE unless eof(); # not eof(ARGV)!
+ }
+ # now process $line
+ }
+
+=begin original
+
+Note that if there were a C<continue> block on the above code, it would
+get executed only on lines discarded by the regex (since redo skips the
+continue block). A continue block is often used to reset line counters
+or C<m?pat?> one-time matches:
+
+=end original
+
+上記の例で C<continue> ブロックがあったとしたら、それは
+(redo は continue ブロックをスキップするので) 正規表現によって
+捨てられた行だけが実行されるということに注意してください。
+continue ブロックは行カウンターをリセットするとか、
+一度だけマッチする C<m?pat?> をリセットするのに使われます。
+
+ # inspired by :1,$g/fred/s//WILMA/
+ while (<>) {
+ m?(fred)? && s//WILMA $1 WILMA/;
+ m?(barney)? && s//BETTY $1 BETTY/;
+ m?(homer)? && s//MARGE $1 MARGE/;
+ } continue {
+ print "$ARGV $.: $_";
+ close ARGV if eof; # reset $.
+ reset if eof; # reset ?pat?
+ }
+
+=begin original
+
+If the word C<while> is replaced by the word C<until>, the sense of the
+test is reversed, but the conditional is still tested before the first
+iteration.
+
+=end original
+
+C<while> を C<until> で置き換えた場合検査の意味は逆転しますが、
+繰り返しが実行されるより前に条件が検査されることは変わりありません。
+
+=begin original
+
+Loop control statements don't work in an C<if> or C<unless>, since
+they aren't loops. You can double the braces to make them such, though.
+
+=end original
+
+ループ制御文は C<if> や C<unless> 中では動作しません;
+なぜならそこはループではないからです。
+しかし中かっこを二重にしてこれに対処することはできます。
+
+ if (/pattern/) {{
+ last if /fred/;
+ next if /barney/; # same effect as "last",
+ # but doesn't document as well
+ # do something here
+ }}
+
+=begin original
+
+This is caused by the fact that a block by itself acts as a loop that
+executes once, see L<"Basic BLOCKs">.
+
+=end original
+
+これは、ブロック自身は一度だけ実行されるループとして動作するからです;
+L<"Basic BLOCKs"> を参照してください。
+
+=begin original
+
+The form C<while/if BLOCK BLOCK>, available in Perl 4, is no longer
+available. Replace any occurrence of C<if BLOCK> by C<if (do BLOCK)>.
+
+=end original
+
+Perl 4 では使うことのできた C<while/if BLOCK BLOCK> という形式は、
+もはや使うことができません。
+C<if BLOCK> の部分を C<if (do BLOCK)> で置き換えてください。
+
+=head2 For Loops
+X<for> X<foreach>
+
+(for ループ)
+
+=begin original
+
+Perl's C-style C<for> loop works like the corresponding C<while> loop;
+that means that this:
+
+=end original
+
+Perl の C 形式の C<for> ループは、対応する C<while> ループと同様に
+動作します; つまり、以下のものは:
+
+ for ($i = 1; $i < 10; $i++) {
+ ...
+ }
+
+=begin original
+
+is the same as this:
+
+=end original
+
+以下のものと同じです:
+
+ $i = 1;
+ while ($i < 10) {
+ ...
+ } continue {
+ $i++;
+ }
+
+=begin original
+
+There is one minor difference: if variables are declared with C<my>
+in the initialization section of the C<for>, the lexical scope of
+those variables is exactly the C<for> loop (the body of the loop
+and the control sections).
+X<my>
+
+=end original
+
+小さな違いが一つあります: C<for> の初期化部で C<my> を使って変数が
+宣言された場合、この変数のレキシカルスコープは C<for> ループ
+(ループ本体と制御部) と完全に同じです。
+X<my>
+
+=begin original
+
+As a special case, if the test in the C<for> loop (or the corresponding
+C<while> loop) is empty, it is treated as true. That is, both
+
+=end original
+
+特別な場合として、もし C<for> ループ (または対応する C<while> ループ) の
+テストが空なら、真として扱われます。
+つまり、次のもの
+
+ for (;;) {
+ ...
+ }
+
+=begin original
+
+and
+
+=end original
+
+および
+
+ while () {
+ ...
+ }
+
+=begin original
+
+are treated as infinite loops.
+
+=end original
+
+は無限ループとして扱われます。
+
+=begin original
+
+Besides the normal array index looping, C<for> can lend itself
+to many other interesting applications. Here's one that avoids the
+problem you get into if you explicitly test for end-of-file on
+an interactive file descriptor causing your program to appear to
+hang.
+X<eof> X<end-of-file> X<end of file>
+
+=end original
+
+通常の、配列に対する添え字付けのループのほかにも、C<for> は他の
+多くの興味深いアプリケーションのために借用することができます。
+以下の例は、対話的なファイル記述子の終端を明示的に検査してしまうと
+プログラムをハングアップしたように見えてしまう問題を回避するものです。
+X<eof> X<end-of-file> X<end of file>
+
+ $on_a_tty = -t STDIN && -t STDOUT;
+ sub prompt { print "yes? " if $on_a_tty }
+ for ( prompt(); <STDIN>; prompt() ) {
+ # do something
+ }
+
+=begin original
+
+Using C<readline> (or the operator form, C<< <EXPR> >>) as the
+conditional of a C<for> loop is shorthand for the following. This
+behaviour is the same as a C<while> loop conditional.
+X<readline> X<< <> >>
+
+=end original
+
+C<for> ループの条件として C<readline> (または演算子形式の C<< <EXPR> >>) を
+使う場合、以下のように省略形が使えます。
+この振る舞いは C<while> ループ条件と同じです。
+X<readline> X<< <> >>
+
+ for ( prompt(); defined( $_ = <STDIN> ); prompt() ) {
+ # do something
+ }
+
+=head2 Foreach Loops
+X<for> X<foreach>
+
+(foreach ループ)
+
+=begin original
+
+The C<foreach> loop iterates over a normal list value and sets the scalar
+variable VAR to be each element of the list in turn. If the variable
+is preceded with the keyword C<my>, then it is lexically scoped, and
+is therefore visible only within the loop. Otherwise, the variable is
+implicitly local to the loop and regains its former value upon exiting
+the loop. If the variable was previously declared with C<my>, it uses
+that variable instead of the global one, but it's still localized to
+the loop. This implicit localization occurs I<only> in a C<foreach>
+loop.
+X<my> X<local>
+
+=end original
+
+C<foreach> ループは 通常のリスト値に対しての繰り返しを行い、スカラ変数 VAR に
+リストの要素を繰り返し一回に一つずつセットします。
+変数の前に C<my> というキーワードが置かれていた場合、その変数は
+レキシカルスコープを持ち、したがってそれはループの中でのみ可視となります。
+このキーワードがなければ、変数はループに対してローカルとなり、ループを
+抜けた後で以前の値が再度取得されます。
+変数が事前に C<my> を使って宣言されていたならば、グローバルなものの
+代わりにその変数を使いますが、それもループにローカルなものとなります。
+この暗黙のローカル化は C<foreach> の中で I<のみ> 起きます。
+X<my> X<local>
+
+=begin original
+
+The C<foreach> keyword is actually a synonym for the C<for> keyword, so
+you can use either. If VAR is omitted, C<$_> is set to each value.
+X<$_>
+
+=end original
+
+
+C<foreach> は実際には C<for> の同義語なので、どちらでも使えます。
+VAR が省略された場合には、C<$_> に値が設定されます。
+X<$_>
+
+=begin original
+
+If any element of LIST is an lvalue, you can modify it by modifying
+VAR inside the loop. Conversely, if any element of LIST is NOT an
+lvalue, any attempt to modify that element will fail. In other words,
+the C<foreach> loop index variable is an implicit alias for each item
+in the list that you're looping over.
+X<alias>
+
+=end original
+
+LIST の要素が左辺値であった場合、ループの中で VAR を変更することにより、
+対応する値を変更することができます。
+逆に、LIST の要素が左辺値でない場合は、この要素を修正しようとしても
+失敗します。
+言い換えると、C<foreach> ループの帰納変数がループの対象となっている
+リスト中の個々のアイテムに対するエイリアスになっているからです。
+X<alias>
+
+=begin original
+
+If any part of LIST is an array, C<foreach> will get very confused if
+you add or remove elements within the loop body, for example with
+C<splice>. So don't do that.
+X<splice>
+
+=end original
+
+LIST のいずれかの部分が配列であった場合に、たとえば C<splice> を使って
+ループの本体でその要素を削除したりあるいは追加したりすると
+C<foreach> は非常に混乱してしまいます。
+ですからそういうことをしてはいけません。
+X<splice>
+
+=begin original
+
+C<foreach> probably won't do what you expect if VAR is a tied or other
+special variable. Don't do that either.
+
+=end original
+
+VAR が tie されていたりあるいは他の特殊変数であった場合には
+C<foreach> はあなたのもくろみどおりには動かないでしょう。
+こういうこともしてはいけません。
+
+=begin original
+
+As of Perl 5.22, there is an experimental variant of this loop that accepts
+a variable preceded by a backslash for VAR, in which case the items in the
+LIST must be references. The backslashed variable will become an alias
+to each referenced item in the LIST, which must be of the correct type.
+The variable needn't be a scalar in this case, and the backslash may be
+followed by C<my>. To use this form, you must enable the C<refaliasing>
+feature via C<use feature>. (See L<feature>. See also L<perlref/Assigning
+to References>.)
+
+=end original
+
+Perl 5.22 から、VAR に逆スラッシュを前置する変数を受け付けるという
+このループの実験的なバリエーションがあります; この場合 LIST のアイテムは
+リファレンスでなければなりません。
+逆スラッシュつき変数は LIST の中のアイテムへのリファレンスとなるエイリアスに
+なり; 正しい方でなければなりません。
+この場合変数はスカラである必要はなく、逆スラッシュには C<my> が
+引き続くことができます。
+この形式を使うには、C<use feature> でC <refaliasing> 機能を
+有効にしなければなりません。
+(L<feature> を参照してください。
+L<perlref/Assigning to References> も参照してください。)
+
+=begin original
+
+Examples:
+
+=end original
+
+例:
+
+ for (@ary) { s/foo/bar/ }
+
+ for my $elem (@elements) {
+ $elem *= 2;
+ }
+
+ for $count (reverse(1..10), "BOOM") {
+ print $count, "\n";
+ sleep(1);
+ }
+
+ for (1..15) { print "Merry Christmas\n"; }
+
+ foreach $item (split(/:[\\\n:]*/, $ENV{TERMCAP})) {
+ print "Item: $item\n";
+ }
+
+ use feature "refaliasing";
+ no warnings "experimental::refaliasing";
+ foreach \my %hash (@array_of_hash_references) {
+ # do something which each %hash
+ }
+
+=begin original
+
+Here's how a C programmer might code up a particular algorithm in Perl:
+
+=end original
+
+以下の例は、C プログラマーが Perl でとあるアルゴリズムを記述するときに
+使うであろうやり方です:
+
+ for (my $i = 0; $i < @ary1; $i++) {
+ for (my $j = 0; $j < @ary2; $j++) {
+ if ($ary1[$i] > $ary2[$j]) {
+ last; # can't go to outer :-(
+ }
+ $ary1[$i] += $ary2[$j];
+ }
+ # this is where that last takes me
+ }
+
+=begin original
+
+Whereas here's how a Perl programmer more comfortable with the idiom might
+do it:
+
+=end original
+
+それに対して、次の例は Perl プログラマーが同じことをよりゆったりとして
+行うやり方です:
+
+ OUTER: for my $wid (@ary1) {
+ INNER: for my $jet (@ary2) {
+ next OUTER if $wid > $jet;
+ $wid += $jet;
+ }
+ }
+
+=begin original
+
+See how much easier this is? It's cleaner, safer, and faster. It's
+cleaner because it's less noisy. It's safer because if code gets added
+between the inner and outer loops later on, the new code won't be
+accidentally executed. The C<next> explicitly iterates the other loop
+rather than merely terminating the inner one. And it's faster because
+Perl executes a C<foreach> statement more rapidly than it would the
+equivalent C<for> loop.
+
+=end original
+
+どのくらいこれが簡単になったように見えますか?
+これは明確で、安全で、高速です。
+これは余計なものが少ないので明確なのです。
+これは後で内側のループと外側のループとの間にコードを付加えた場合でも、
+それを間違って実行することがないので安全なのです。
+C<next> は内側のループを終了するのではなく、外側のループの繰り返しを
+行います。
+そしてこれは、Perl は C<foreach> 文をそれと等価な C<for> ループよりも
+すばやく実行するので高速なのです。
+
+=begin original
+
+Perceptive Perl hackers may have noticed that a C<for> loop has a return
+value, and that this value can be captured by wrapping the loop in a C<do>
+block. The reward for this discovery is this cautionary advice: The
+return value of a C<for> loop is unspecified and may change without notice.
+Do not rely on it.
+
+=end original
+
+洞察力のある Perl ハッカーは、C<for> ループに返り値があり、この値は
+ループを C<do> ブロックで包むことによって捕捉できることに
+気付くかもしれません。
+この発見に対する報奨は、この警告的なアドバイスです: C<for> ループの返り値は
+未定義で、予告なしに変更されることがあります。
+これに依存してはいけません。
+
+=head2 Basic BLOCKs
+X<block>
+
+(基本ブロック (BLOCK))
+
+=begin original
+
+A BLOCK by itself (labeled or not) is semantically equivalent to a
+loop that executes once. Thus you can use any of the loop control
+statements in it to leave or restart the block. (Note that this is
+I<NOT> true in C<eval{}>, C<sub{}>, or contrary to popular belief
+C<do{}> blocks, which do I<NOT> count as loops.) The C<continue>
+block is optional.
+
+=end original
+
+ブロックそれ自身は(ラベルが付いていようがついてなかろうが)一度だけ
+実行されるループと、文法的には等価なものです。
+このため、ブロックから脱出するためやブロックの再スタートのために
+任意のループ制御文を使うことができます。
+(これは C<eval{}>、C<sub{}>、
+さらに一般的な認識とは異なり I<ループではない> C<do{}> ブロックに対しては
+I<真ではない> ということに注意してください。)
+C<continue> ブロックは省略することができます。
+
+=begin original
+
+The BLOCK construct can be used to emulate case structures.
+
+=end original
+
+BLOCK 構造は case 構造を行うのにも使えます。
+
+ SWITCH: {
+ if (/^abc/) { $abc = 1; last SWITCH; }
+ if (/^def/) { $def = 1; last SWITCH; }
+ if (/^xyz/) { $xyz = 1; last SWITCH; }
+ $nothing = 1;
+ }
+
+=begin original
+
+You'll also find that C<foreach> loop used to create a topicalizer
+and a switch:
+
+=end original
+
+主題化器とスイッチを作るために使われた C<foreach> ループも見るかもしれません:
+
+ SWITCH:
+ for ($var) {
+ if (/^abc/) { $abc = 1; last SWITCH; }
+ if (/^def/) { $def = 1; last SWITCH; }
+ if (/^xyz/) { $xyz = 1; last SWITCH; }
+ $nothing = 1;
+ }
+
+=begin original
+
+Such constructs are quite frequently used, both because older versions of
+Perl had no official C<switch> statement, and also because the new version
+described immediately below remains experimental and can sometimes be confusing.
+
+=end original
+
+古いバージョンの Perl には公式の C<switch> 文がなく、直後に記述する
+新しいバージョンはまだ実験的で時々混乱させることがあるので、
+このような構文はとてもよく使われています。
+
+=head2 Switch Statements
+
+(switch 文)
+
+X<switch> X<case> X<given> X<when> X<default>
+
+=begin original
+
+Starting from Perl 5.10.1 (well, 5.10.0, but it didn't work
+right), you can say
+
+=end original
+
+Perl 5.10.1 から(えっと、5.10.0 からですが、正しく動いていませんでした)、
+以下のように書くと:
+
+ use feature "switch";
+
+=begin original
+
+to enable an experimental switch feature. This is loosely based on an
+old version of a Perl 6 proposal, but it no longer resembles the Perl 6
+construct. You also get the switch feature whenever you declare that your
+code prefers to run under a version of Perl that is 5.10 or later. For
+example:
+
+=end original
+
+実験的な switch 機能を有効にします。
+これはおおまかに Perl 6 提案の古い版を基にしていますが、もはや
+Perl 6 の構文と共通点はありません。
+コードが 5.10 以降の Perl バージョンで実行されるように宣言したときもいつでも
+switch 機能を得られます。
+例えば:
+
+ use v5.14;
+
+=begin original
+
+Under the "switch" feature, Perl gains the experimental keywords
+C<given>, C<when>, C<default>, C<continue>, and C<break>.
+Starting from Perl 5.16, one can prefix the switch
+keywords with C<CORE::> to access the feature without a C<use feature>
+statement. The keywords C<given> and
+C<when> are analogous to C<switch> and
+C<case> in other languages, so the code in the previous section could be
+rewritten as
+
+=end original
+
+"switch" 機能の基では、Perl は実験的なキーワード C<given>, C<when>,
+C<default>, C<continue>, C<break> を得ます。
+Perl 5.16 から、C<use feature> 文なしで機能にアクセスするために、
+switch キーワードに C<CORE::> を前置できます。
+キーワード C<given> と C<when> は他の言語での C<switch> および C<case> と
+同様のものなので、前の節のコードは以下のように書き直せます:
+
+ use v5.10.1;
+ for ($var) {
+ when (/^abc/) { $abc = 1 }
+ when (/^def/) { $def = 1 }
+ when (/^xyz/) { $xyz = 1 }
+ default { $nothing = 1 }
+ }
+
+=begin original
+
+The C<foreach> is the non-experimental way to set a topicalizer.
+If you wish to use the highly experimental C<given>, that could be
+written like this:
+
+=end original
+
+C<foreach> は主題化器を設定する実験的でない方法です。
+とても実験的な C<given> を使いたいなら、以下のように書けます:
+
+ use v5.10.1;
+ given ($var) {
+ when (/^abc/) { $abc = 1 }
+ when (/^def/) { $def = 1 }
+ when (/^xyz/) { $xyz = 1 }
+ default { $nothing = 1 }
+ }
+
+=begin original
+
+As of 5.14, that can also be written this way:
+
+=end original
+
+5.14 現在、これは以下のようにも書けます:
+
+ use v5.14;
+ for ($var) {
+ $abc = 1 when /^abc/;
+ $def = 1 when /^def/;
+ $xyz = 1 when /^xyz/;
+ default { $nothing = 1 }
+ }
+
+=begin original
+
+Or if you don't care to play it safe, like this:
+
+=end original
+
+あるいは、安全にすることを気にしないなら、以下のようにします:
+
+ use v5.14;
+ given ($var) {
+ $abc = 1 when /^abc/;
+ $def = 1 when /^def/;
+ $xyz = 1 when /^xyz/;
+ default { $nothing = 1 }
+ }
+
+=begin original
+
+The arguments to C<given> and C<when> are in scalar context,
+and C<given> assigns the C<$_> variable its topic value.
+
+=end original
+
+C<given> と C<when> への引数はスカラコンテキストで、
+C<given> は C<$_> 変数に注目している値を代入します。
+
+=begin original
+
+Exactly what the I<EXPR> argument to C<when> does is hard to describe
+precisely, but in general, it tries to guess what you want done. Sometimes
+it is interpreted as C<< $_ ~~ I<EXPR> >>, and sometimes it is not. It
+also behaves differently when lexically enclosed by a C<given> block than
+it does when dynamically enclosed by a C<foreach> loop. The rules are far
+too difficult to understand to be described here. See L</"Experimental Details
+on given and when"> later on.
+
+=end original
+
+C<when> への I<EXPR> 引数が正確に何をするかを正確に記述するのは
+難しいですが、一般的には、あなたのしたいことを推測しようとします。
+これは C<< $_ ~~ I<EXPR> >> として解釈される場合もあり、そうでない場合も
+あります。
+これはまた、C<given> ブロックでレキシカルに囲まれた場合は、C<foreach>
+ループによって動的に囲まれた場合とは異なった振る舞いをします。
+規則はここで記述されたよりも遥かに理解しにくいものです。
+後述する L</"Experimental Details on given and when"> を参照してください。
+
+=begin original
+
+Due to an unfortunate bug in how C<given> was implemented between Perl 5.10
+and 5.16, under those implementations the version of C<$_> governed by
+C<given> is merely a lexically scoped copy of the original, not a
+dynamically scoped alias to the original, as it would be if it were a
+C<foreach> or under both the original and the current Perl 6 language
+specification. This bug was fixed in Perl
+5.18. If you really want a lexical C<$_>,
+specify that explicitly, but note that C<my $_>
+is now deprecated and will warn unless warnings
+have been disabled:
+
+=end original
+
+Perl 5.10 と 5.14 の間での C<given> の実装方法による不幸なバグにより、
+現在の実装では、C<given> によって管理される C<$_> は、
+C<foreach> の場合やオリジナルと現在両方の Perl 6 言語仕様のように
+元のものの動的スコープな別名ではなく、単なるレキシカルスコープのコピーです。
+このバグは Perl 5.18 で修正されました。
+本当にレキシカルな C<$_> がほしいなら、明示的に指定しますが、C<my $_> は
+非推奨になって、警告を無効にしない限り警告されるようになったことに
+注意してください:
+
+ given(my $_ = EXPR) { ... }
+
+=begin original
+
+If your code still needs to run on older versions,
+stick to C<foreach> for your topicalizer and
+you will be less unhappy.
+
+=end original
+
+あなたのコードがまだ古いバージョンでも動作する必要があるなら、
+主題化器には C<foreach> を使うことで不幸を減らせます。
+
+=head2 Goto
+X<goto>
+
+(goto 文)
+
+=begin original
+
+Although not for the faint of heart, Perl does support a C<goto>
+statement. There are three forms: C<goto>-LABEL, C<goto>-EXPR, and
+C<goto>-&NAME. A loop's LABEL is not actually a valid target for
+a C<goto>; it's just the name of the loop.
+
+=end original
+
+気弱な人のためでないにも関らず、Perl は C<goto> 文をサポートしています。
+C<goto>-LABEL、C<goto>-EXPR、C<goto>-&NAME の三つの形式があります。
+ループのラベルは実際には C<goto> の正当なターゲットではなく、
+ループの名前にすぎません。
+
+=begin original
+
+The C<goto>-LABEL form finds the statement labeled with LABEL and resumes
+execution there. It may not be used to go into any construct that
+requires initialization, such as a subroutine or a C<foreach> loop. It
+also can't be used to go into a construct that is optimized away. It
+can be used to go almost anywhere else within the dynamic scope,
+including out of subroutines, but it's usually better to use some other
+construct such as C<last> or C<die>. The author of Perl has never felt the
+need to use this form of C<goto> (in Perl, that is--C is another matter).
+
+=end original
+
+C<goto>-LABEL 形式は LABEL でラベル付けされた文を見つけだし、そこから
+実行を再開します。
+これはサブルーチンであるとか C<foreach> ループのような
+初期化を必要とするような構造へ飛び込むために使うことはできません。
+また、最適化されて無くなってしまうような構造へ飛び込むこともできません。
+動的スコープの中以外のほとんどの場所へは、サブルーチンの外も含めて
+移動することができます; しかし、通常は C<last> や C<die> のような
+別のやり方を使ったほうが良いでしょう。
+Perl の作者は、未だかつてこの形式の C<goto> を使うことが
+必要だと感じたことはありません(Perl の場合です--C の場合はまた別の話です)。
+
+=begin original
+
+The C<goto>-EXPR form expects a label name, whose scope will be resolved
+dynamically. This allows for computed C<goto>s per FORTRAN, but isn't
+necessarily recommended if you're optimizing for maintainability:
+
+=end original
+
+C<goto>-EXPR 形式は動的に解決されるスコープを持っているラベル名を
+期待しています。
+これによって FORTRAN の計算型 C<goto> が実現できますが、
+これは保守性に重きを置くのであれば使うことは止めた方が良いでしょう。
+
+ goto(("FOO", "BAR", "GLARCH")[$i]);
+
+=begin original
+
+The C<goto>-&NAME form is highly magical, and substitutes a call to the
+named subroutine for the currently running subroutine. This is used by
+C<AUTOLOAD()> subroutines that wish to load another subroutine and then
+pretend that the other subroutine had been called in the first place
+(except that any modifications to C<@_> in the current subroutine are
+propagated to the other subroutine.) After the C<goto>, not even C<caller()>
+will be able to tell that this routine was called first.
+
+=end original
+
+C<goto>-&NAME は高度にマジカルで、名前付きサブルーチンの呼び出しを
+カレントで実行されているサブルーチンに置き換えます。
+これは別のサブルーチンをロードして、最初の場所で呼び出された
+別のサブルーチンを要求することをしようとする
+C<AUTOLOAD()> サブルーチンで使われていてます
+(カレントのサブルーチンにおける C<@_> に対するもの以外の変更は、
+別のサブルーチンへ伝播します)。
+C<goto> の後で、C<caller()> でなくてもこのサブルーチンが
+最初に呼ばれたのだということを伝えることすらできるでしょう。
+
+=begin original
+
+In almost all cases like this, it's usually a far, far better idea to use the
+structured control flow mechanisms of C<next>, C<last>, or C<redo> instead of
+resorting to a C<goto>. For certain applications, the catch and throw pair of
+C<eval{}> and die() for exception processing can also be a prudent approach.
+
+=end original
+
+このようなケースのほとんどすべての場合、C<goto> に頼るのではなくて
+C<next>、C<last>、C<redo> といった制御フロー機構を使うことが、
+ずっとずっと良いアイデアでしょう。
+一部のアプリケーションに対しては、C<eval{}> と die() を
+catch と throw のペアとして例外処理を行うための賢明なアプローチとして
+使うことができるでしょう。
+
+=head2 The Ellipsis Statement
+X<...>
+X<... statement>
+X<ellipsis operator>
+X<elliptical statement>
+X<unimplemented statement>
+X<unimplemented operator>
+X<yada-yada>
+X<yada-yada operator>
+X<... operator>
+X<whatever operator>
+X<triple-dot operator>
+
+(省略文)
+
+=begin original
+
+Beginning in Perl 5.12, Perl accepts an ellipsis, "C<...>", as a
+placeholder for code that you haven't implemented yet. This form of
+ellipsis, the unimplemented statement, should not be confused with the
+binary flip-flop C<...> operator. One is a statement and the other an
+operator. (Perl doesn't usually confuse them because usually Perl can tell
+whether it wants an operator or a statement, but see below for exceptions.)
+
+=end original
+
+Perl 5.12 から、Perl はまだ実装していないコードのプレースホルダとして
+省略 "C<...>" を受け付けるようになりました。
+この形式の省略、未実装文は、二項フリップフロップ C<...> 演算子と
+混乱しないでください。
+片方は文で、もう片方は演算子です。
+(Perl は普通混乱しません; なぜなら普通は Perl は演算子を求めているか
+文を求めているかを伝えるからです; しかし以下の例外を参照してください。)
+
+=begin original
+
+When Perl 5.12 or later encounters an ellipsis statement, it parses this
+without error, but if and when you should actually try to execute it, Perl
+throws an exception with the text C<Unimplemented>:
+
+=end original
+
+Perl 5.12 以降で省略文に遭遇すると、エラーなくパースしますが、実際に
+実行しようとすると、C<Unimplemented> というテキストと共に例外を投げます:
+
+ use v5.12;
+ sub unimplemented { ... }
+ eval { unimplemented() };
+ if ($@ =~ /^Unimplemented at /) {
+ say "I found an ellipsis!";
+ }
+
+=begin original
+
+You can only use the elliptical statement to stand in for a
+complete statement. These examples of how the ellipsis works:
+
+=end original
+
+完全な文を使える場所でのみ省略文を使えます。
+次の例は省略がどのように動作するかの例です:
+
+ use v5.12;
+ { ... }
+ sub foo { ... }
+ ...;
+ eval { ... };
+ sub somemeth {
+ my $self = shift;
+ ...;
+ }
+ $x = do {
+ my $n;
+ ...;
+ say "Hurrah!";
+ $n;
+ };
+
+=begin original
+
+The elliptical statement cannot stand in for an expression that
+is part of a larger statement, since the C<...> is also the three-dot
+version of the flip-flop operator (see L<perlop/"Range Operators">).
+
+=end original
+
+C<...> はフリップフロップ演算子(L<Range Operators> 参照)の 3 点版でも
+あるので、省略文はより大きな文の一部の式としては使えません。
+
+=begin original
+
+These examples of attempts to use an ellipsis are syntax errors:
+
+=end original
+
+省略を使おうとする以下の例は文法エラーになります:
+
+ use v5.12;
+
+ print ...;
+ open(my $fh, ">", "/dev/passwd") or ...;
+ if ($condition && ... ) { say "Howdy" };
+
+=begin original
+
+There are some cases where Perl can't immediately tell the difference
+between an expression and a statement. For instance, the syntax for a
+block and an anonymous hash reference constructor look the same unless
+there's something in the braces to give Perl a hint. The ellipsis is a
+syntax error if Perl doesn't guess that the C<{ ... }> is a block. In that
+case, it doesn't think the C<...> is an ellipsis because it's expecting an
+expression instead of a statement:
+
+=end original
+
+式と文との違いをすぐに説明できない場合があります。
+例えば、ブロックと無名ハッシュリファレンスのコンストラクタは、
+Perl にヒントを与える中かっこがなければ同じに見えます。
+省略文は Perl が C<{ ... }> をブロックと判断できなかった場合は
+文法エラーとなります。
+この場合、文ではなく式と推測するので、C<...> は省略とは判断されません:
+
+ @transformed = map { ... } @input; # syntax error
+
+=begin original
+
+Inside your block, you can use a C<;> before the ellipsis to denote that the
+C<{ ... }> is a block and not a hash reference constructor. Now the ellipsis
+works:
+
+=end original
+
+ブロックの中では、C<{ ... }> がブロックであってハッシュリファレンスの
+コンストラクタでないことを示すために、省略の前に C<;> を使えます。
+これで省略は動作します:
+
+=begin original
+
+ @transformed = map {; ... } @input; # ';' disambiguates
+
+=end original
+
+ @transformed = map {; ... } @input; # ';' 曖昧でない
+
+=begin original
+
+Note: Some folks colloquially refer to this bit of punctuation as a
+"yada-yada" or "triple-dot", but its true name
+is actually an ellipsis.
+
+=end original
+
+注意: 一部の人間はこの句読点を口語的に「ヤダヤダ」や「3 点」として
+参照しますが、真の名前は実際には省略です。
+
+=head2 PODs: Embedded Documentation
+X<POD> X<documentation>
+
+(POD: 組み込みドキュメント)
+
+=begin original
+
+Perl has a mechanism for intermixing documentation with source code.
+While it's expecting the beginning of a new statement, if the compiler
+encounters a line that begins with an equal sign and a word, like this
+
+=end original
+
+Perl は、ソースコードとドキュメントとを混ぜ書きするための仕掛けを
+持っています。
+新しい文の始まりが期待されているときに、コンパイラは
+以下の例のような = 記号で始まっている語を見つけると:
+
+ =head1 Here There Be Pods!
+
+=begin original
+
+Then that text and all remaining text up through and including a line
+beginning with C<=cut> will be ignored. The format of the intervening
+text is described in L<perlpod>.
+
+=end original
+
+そのテキストと、C<=cut> で始まる行までの内容を無視します。
+間に入るテキストの書式は L<perlpod> で説明されています。
+
+=begin original
+
+This allows you to intermix your source code
+and your documentation text freely, as in
+
+=end original
+
+これによって、ソースコードとドキュメントとを以下に示す例のように
+自由に混ぜることができるようになります。
+
+ =item snazzle($)
+
+ The snazzle() function will behave in the most spectacular
+ form that you can possibly imagine, not even excepting
+ cybernetic pyrotechnics.
+
+ =cut back to the compiler, nuff of this pod stuff!
+
+ sub snazzle($) {
+ my $thingie = shift;
+ .........
+ }
+
+=begin original
+
+Note that pod translators should look at only paragraphs beginning
+with a pod directive (it makes parsing easier), whereas the compiler
+actually knows to look for pod escapes even in the middle of a
+paragraph. This means that the following secret stuff will be
+ignored by both the compiler and the translators.
+
+=end original
+
+コンパイラはパラグラフの途中に pod エスケープがあったとしてもそれを
+認識できるのに、pod トランスレータは pod 指示子で始まっている
+パラグラフのみに注目すべき(これは構文解析を簡単にするためです)で
+あるということに注意して下さい。
+つまり、以下の例にある "secret stuff" はコンパイラからも、
+トランスレータからも無視されるということです。
+
+ $a=3;
+ =secret stuff
+ warn "Neither POD nor CODE!?"
+ =cut back
+ print "got $a\n";
+
+=begin original
+
+You probably shouldn't rely upon the C<warn()> being podded out forever.
+Not all pod translators are well-behaved in this regard, and perhaps
+the compiler will become pickier.
+
+=end original
+
+この例の C<warn()> のようなものが、将来に渡って無視されるということに
+依存すべきではありません。
+すべての pod トランスレータがそのように振る舞うわけではありませんし、
+コンパイラは将来これを無視しないようになるかもしれません。
+
+=begin original
+
+One may also use pod directives to quickly comment out a section
+of code.
+
+=end original
+
+pod 指示子を、コードの一部を手っ取り早くコメントアウトするために
+使うこともできます。
+
+=head2 Plain Old Comments (Not!)
+X<comment> X<line> X<#> X<preprocessor> X<eval>
+
+=begin original
+
+Perl can process line directives, much like the C preprocessor. Using
+this, one can control Perl's idea of filenames and line numbers in
+error or warning messages (especially for strings that are processed
+with C<eval()>). The syntax for this mechanism is almost the same as for
+most C preprocessors: it matches the regular expression
+
+=end original
+
+C のプリプロセッサと同じように、Perl は行指示子を処理できます。
+これを使うことによって、エラーメッセージや警告メッセージにある
+ファイル名や行番号を制御することができます
+(特に、C<eval()> で処理される文字列のために)。
+この仕組みの構文はほとんどの C のプリプロセッサとほとんど同じで、正規表現:
+
+ # example: '# line 42 "new_filename.plx"'
+ /^\# \s*
+ line \s+ (\d+) \s*
+ (?:\s("?)([^"]+)\g2)? \s*
+ $/x
+
+=begin original
+
+with C<$1> being the line number for the next line, and C<$3> being
+the optional filename (specified with or without quotes). Note that
+no whitespace may precede the C<< # >>, unlike modern C preprocessors.
+
+=end original
+
+にマッチしたものの C<$1> が次の行の行番号となり、省略することもできる
+C<$3> は(クォートありかなしで指定された)ファイル名となります。
+最近の C プリプロセッサとは違って、C<< # >> の前に空白を置けないことに
+注意してください。
+
+=begin original
+
+There is a fairly obvious gotcha included with the line directive:
+Debuggers and profilers will only show the last source line to appear
+at a particular line number in a given file. Care should be taken not
+to cause line number collisions in code you'd like to debug later.
+
+=end original
+
+行指示子にはかなり明らかな技があります: デバッガとプロファイラは、
+与えられたファイルの特定の行番号に対して現れた最新のソース行のみを
+表示します。
+あとでデバッグしたいコードでは行番号の衝突が起きないように注意するべきです。
+
+=begin original
+
+Here are some examples that you should be able to type into your command
+shell:
+
+=end original
+
+コマンドシェルでタイプすることのできる例をいくつか挙げます:
+
+ % perl
+ # line 200 "bzzzt"
+ # the '#' on the previous line must be the first char on line
+ die 'foo';
+ __END__
+ foo at bzzzt line 201.
+
+ % perl
+ # line 200 "bzzzt"
+ eval qq[\n#line 2001 ""\ndie 'foo']; print $@;
+ __END__
+ foo at - line 2001.
+
+ % perl
+ eval qq[\n#line 200 "foo bar"\ndie 'foo']; print $@;
+ __END__
+ foo at foo bar line 200.
+
+ % perl
+ # line 345 "goop"
+ eval "\n#line " . __LINE__ . ' "' . __FILE__ ."\"\ndie 'foo'";
+ print $@;
+ __END__
+ foo at goop line 345.
+
+=head2 Experimental Details on given and when
+
+(given と when の実験的な詳細)
+
+=begin original
+
+As previously mentioned, the "switch" feature is considered highly
+experimental; it is subject to change with little notice. In particular,
+C<when> has tricky behaviours that are expected to change to become less
+tricky in the future. Do not rely upon its current (mis)implementation.
+Before Perl 5.18, C<given> also had tricky behaviours that you should still
+beware of if your code must run on older versions of Perl.
+
+=end original
+
+既に述べたように、"switch" 機能は非常に実験的であると考えられています;
+ほとんど知らせることなく変更されることがあります。
+特に C<when> はトリッキーな振る舞いがあり、将来よりトリッキーで
+なくなるように変更される予定です。
+現在の(誤)実装に依存しないでください。
+Perl 5.18 より前では、C<given> には、コードが古いバージョンの Perl でも
+動かなければならない場合に気をつけるべきトリッキーな振る舞いもあります:
+
+=begin original
+
+Here is a longer example of C<given>:
+
+=end original
+
+これはより長い C<given> の例です:
+
+ use feature ":5.10";
+ given ($foo) {
+ when (undef) {
+ say '$foo is undefined';
+ }
+ when ("foo") {
+ say '$foo is the string "foo"';
+ }
+ when ([1,3,5,7,9]) {
+ say '$foo is an odd digit';
+ continue; # Fall through
+ }
+ when ($_ < 100) {
+ say '$foo is numerically less than 100';
+ }
+ when (\&complicated_check) {
+ say 'a complicated check for $foo is true';
+ }
+ default {
+ die q(I don't know what to do with $foo);
+ }
+ }
+
+=begin original
+
+Before Perl 5.18, C<given(EXPR)> assigned the value of I<EXPR> to
+merely a lexically scoped I<B<copy>> (!) of C<$_>, not a dynamically
+scoped alias the way C<foreach> does. That made it similar to
+
+=end original
+
+Perl 5.18 より前では、C<given(EXPR)> は I<EXPR> の値を単にレキシカルスコープを
+持つ C<$_> の I<B<コピー>> (!) に代入します; C<foreach> がするような動的
+スコープを持つ別名ではありません。
+これは以下と似ています:
+
+ do { my $_ = EXPR; ... }
+
+=begin original
+
+except that the block was automatically broken out of by a successful
+C<when> or an explicit C<break>. Because it was only a copy, and because
+it was only lexically scoped, not dynamically scoped, you could not do the
+things with it that you are used to in a C<foreach> loop. In particular,
+it did not work for arbitrary function calls if those functions might try
+to access $_. Best stick to C<foreach> for that.
+
+=end original
+
+しかし、ブロックは C<when> が成功するか、明示的な C<break> によって
+自動的に破壊されるところが違いました。
+これはただのコピーで、動的スコープではなくレキシカルなスコープしか
+持たないので、C<foreach> ループの中でできるようなことはできませんでした。
+特に、$_ にアクセスしようとするかもしれない関数の場合、任意の関数呼び出しに
+対しては動作していませんでした。
+そのためには C<foreach> にこだわるのが最良です。
+
+=begin original
+
+Most of the power comes from the implicit smartmatching that can
+sometimes apply. Most of the time, C<when(EXPR)> is treated as an
+implicit smartmatch of C<$_>, that is, C<$_ ~~ EXPR>. (See
+L<perlop/"Smartmatch Operator"> for more information on smartmatching.)
+But when I<EXPR> is one of the 10 exceptional cases (or things like them)
+listed below, it is used directly as a boolean.
+
+=end original
+
+強力さのほとんどは時々適用される暗黙のスマートマッチングによるものです。
+ほとんどの場合、C<when(EXPR)> は暗黙の C<$_> のスマートマッチング、
+つまり C<$_ ~~ EXPR> として扱われます。
+(スマートマッチングに関するさらなる情報については
+L<perlop/"Smartmatch Operator"> を参照してください。)
+しかし I<EXPR> が後述する 10 の例外の場合(および似たような場合) の
+一つの場合、直接真偽値として使われます。
+
+=over 4
+
+=item Z<>1.
+
+=begin original
+
+A user-defined subroutine call or a method invocation.
+
+=end original
+
+ユーザー定義サブルーチンかメソッド呼び出し。
+
+=item Z<>2.
+
+=begin original
+
+A regular expression match in the form of C</REGEX/>, C<$foo =~ /REGEX/>,
+or C<$foo =~ EXPR>. Also, a negated regular expression match in
+the form C<!/REGEX/>, C<$foo !~ /REGEX/>, or C<$foo !~ EXPR>.
+
+=end original
+
+C</REGEX/>, C<$foo =~ /REGEX/>, C<$foo =~ EXPR> 形式の 正規表現マッチング。
+また、C<!/REGEX/>, C<$foo !~ /REGEX/>, C<$foo !~ EXPR> 形式の
+正規表現マッチングの否定。
+
+=item Z<>3.
+
+=begin original
+
+A smart match that uses an explicit C<~~> operator, such as C<EXPR ~~ EXPR>.
+
+=end original
+
+C<EXPR ~~ EXPR> のように、明示的に C<~~> 演算子を使うスマートマッチング。
+
+=begin original
+
+B<NOTE:> You will often have to use C<$c ~~ $_> because the default case
+uses C<$_ ~~ $c> , which is frequentlythe opposite of what you want.
+
+=end original
+
+B<注意:> しばしば C<$c ~~ $_> を使う必要があることに注意してください;
+なぜならデフォルトの場合は C<$_ ~~ $c> を使い、これはしばしばしたいことの
+逆だからです。
+
+=item Z<>4.
+
+=begin original
+
+A boolean comparison operator such as C<$_ E<lt> 10> or C<$x eq "abc">. The
+relational operators that this applies to are the six numeric comparisons
+(C<< < >>, C<< > >>, C<< <= >>, C<< >= >>, C<< == >>, and C<< != >>), and
+the six string comparisons (C<lt>, C<gt>, C<le>, C<ge>, C<eq>, and C<ne>).
+
+=end original
+
+C<$_ E<lt> 10> や C<$x eq "abc"> のような真偽値比較。
+これを適用する関係演算子は、六つの数値比較
+(C<< < >>, C<< > >>, C<< <= >>, C<< >= >>, C<< == >>, C<< != >>) および
+六つの文字列比較 (C<lt>, C<gt>, C<le>, C<ge>, C<eq>, C<ne>) です。
+
+=item Z<>5.
+
+=begin original
+
+At least the three builtin functions C<defined(...)>, C<exists(...)>, and
+C<eof(...)>. We might someday add more of these later if we think of them.
+
+=end original
+
+少なくとも三つの組み込み関数 C<defined(...)>, C<exists(...)>, C<eof(...)>。
+これらについて考えるとき、いつかもっと追加するかもしれません。
+
+=item Z<>6.
+
+=begin original
+
+A negated expression, whether C<!(EXPR)> or C<not(EXPR)>, or a logical
+exclusive-or, C<(EXPR1) xor (EXPR2)>. The bitwise versions (C<~> and C<^>)
+are not included.
+
+=end original
+
+否定表現 C<!(EXPR)> または C<not(EXPR)>、 排他的論理和
+C<(EXPR1) xor (EXPR2)>。
+ビット版 (C<~> と C<^>) は含まれません。
+
+=item Z<>7.
+
+=begin original
+
+A filetest operator, with exactly 4 exceptions: C<-s>, C<-M>, C<-A>, and
+C<-C>, as these return numerical values, not boolean ones. The C<-z>
+filetest operator is not included in the exception list.
+
+=end original
+
+真偽値ではなく数値を返す四つの例外: C<-s>, C<-M>, C<-A>, C<-C> を除く
+ファイルテスト演算子。
+C<-z> ファイルテスト演算子は例外の一覧には含まれません。
+
+=item Z<>8.
+
+=begin original
+
+The C<..> and C<...> flip-flop operators. Note that the C<...> flip-flop
+operator is completely different from the C<...> elliptical statement
+just described.
+
+=end original
+
+フリップフロップ演算子 C<..> と C<...>。
+C<...> フリップフロップ演算子は先に記述した C<...> 省略文とは完全に
+異なることに注意してください。
+
+=back
+
+=begin original
+
+In those 8 cases above, the value of EXPR is used directly as a boolean, so
+no smartmatching is done. You may think of C<when> as a smartsmartmatch.
+
+=end original
+
+上述の八つの場合、EXPR の値は直接真偽値として使われるため、
+スマートマッチングは行われません。
+スマートマッチングとして C<when> を考えるかもしれません。
+
+=begin original
+
+Furthermore, Perl inspects the operands of logical operators to
+decide whether to use smartmatching for each one by applying the
+above test to the operands:
+
+=end original
+
+更に、Perl はオペランドに上述のテストを適用することで、それぞれに
+スマートマッチングを使うかどうかを決定するために論理演算子の
+オペランドを調べます:
+
+=over 4
+
+=item Z<>9.
+
+=begin original
+
+If EXPR is C<EXPR1 && EXPR2> or C<EXPR1 and EXPR2>, the test is applied
+I<recursively> to both EXPR1 and EXPR2.
+Only if I<both> operands also pass the
+test, I<recursively>, will the expression be treated as boolean. Otherwise,
+smartmatching is used.
+
+=end original
+
+EXPR が C<EXPR1 && EXPR2> または C<EXPR1 and EXPR2> の場合、テストは
+EXPR1 と EXPR2 の両方に I<再帰的> に適用されます。
+I<両方の> オペランドがテストに I<再帰的に> 成功した場合にのみ、この式は
+真偽値として扱われます。
+さもなければ、スマートマッチングが使われます。
+
+=item Z<>10.
+
+=begin original
+
+If EXPR is C<EXPR1 || EXPR2>, C<EXPR1 // EXPR2>, or C<EXPR1 or EXPR2>, the
+test is applied I<recursively> to EXPR1 only (which might itself be a
+higher-precedence AND operator, for example, and thus subject to the
+previous rule), not to EXPR2. If EXPR1 is to use smartmatching, then EXPR2
+also does so, no matter what EXPR2 contains. But if EXPR2 does not get to
+use smartmatching, then the second argument will not be either. This is
+quite different from the C<&&> case just described, so be careful.
+
+=end original
+
+EXPR が C<EXPR1 || EXPR2>, C<EXPR1 // EXPR2>, or C<EXPR1 or EXPR2> の場合、
+テストは EXPR1 (例えば、より高い優先順位である AND 演算子; 従って
+前述の規則に従う)のみに対して I<再帰的に> 適用されます; EXPR2 には
+適用されません。
+EXPR1 がスマートマッチングを使うなら、EXPR2 も、その内容に関わらず
+そうします。
+しかし EXPR2 がスマートマッチングを塚ｗないなら、二番目の引数はどちらでも
+ありません。
+これは既に記述した C<&&> の場合とはかなり異なりますので注意してください。
+
+=back
+
+=begin original
+
+These rules are complicated, but the goal is for them to do what you want
+(even if you don't quite understand why they are doing it). For example:
+
+=end original
+
+これらの規則は複雑ですが、この目標は (たとえあなたがなぜそうしているかを
+完全に理解していなくても) あなたが実行したい通りに実行することです。
+例えば:
+
+ when (/^\d+$/ && $_ < 75) { ... }
+
+=begin original
+
+will be treated as a boolean match because the rules say both
+a regex match and an explicit test on C<$_> will be treated
+as boolean.
+
+=end original
+
+これは真偽値マッチングとして扱われます; 規則では正規表現マッチングと
+C<$_> への明示的なテストはどちらも真偽値として扱われるからです。
+
+=begin original
+
+Also:
+
+=end original
+
+また:
+
+ when ([qw(foo bar)] && /baz/) { ... }
+
+=begin original
+
+will use smartmatching because only I<one> of the operands is a boolean:
+the other uses smartmatching, and that wins.
+
+=end original
+
+これはスマートマッチングを使います; オペランドの I<一つ> だけが
+真偽値だからです: もう片方はスマートマッチングを使うので、こちらが
+優先されます。
+
+=begin original
+
+Further:
+
+=end original
+
+さらに:
+
+ when ([qw(foo bar)] || /^baz/) { ... }
+
+=begin original
+
+will use smart matching (only the first operand is considered), whereas
+
+=end original
+
+これはスマートマッチングを使います(最初のオペランドのみが考慮されます); 一方
+
+ when (/^baz/ || [qw(foo bar)]) { ... }
+
+=begin original
+
+will test only the regex, which causes both operands to be
+treated as boolean. Watch out for this one, then, because an
+arrayref is always a true value, which makes it effectively
+redundant. Not a good idea.
+
+=end original
+
+これは正規表現のみがテストされ、両方のオペランドは真偽値として
+扱われることになります。
+この場合、配列リファレンスは常に真の値なので、効率的に冗長になることに
+注目してください。
+良い考えではありません。
+
+=begin original
+
+Tautologous boolean operators are still going to be optimized
+away. Don't be tempted to write
+
+=end original
+
+恒久的な真偽値演算子は最適化されて除去されます。
+以下のように書こうとしないでください
+
+ when ("foo" or "bar") { ... }
+
+=begin original
+
+This will optimize down to C<"foo">, so C<"bar"> will never be considered (even
+though the rules say to use a smartmatch
+on C<"foo">). For an alternation like
+this, an array ref will work, because this will instigate smartmatching:
+
+=end original
+
+これは C<"foo"> に最適化されるので、C<"bar"> は (たとえ規則では C<"foo"> に
+スマートマッチングを使うとなっていたとしても) 考慮されることはありません。
+このような代替としては、配列リファレンスは動作します; これは
+スマートマッチングを使わせるからです:
+
+ when ([qw(foo bar)] { ... }
+
+=begin original
+
+This is somewhat equivalent to the C-style switch statement's fallthrough
+functionality (not to be confused with I<Perl's> fallthrough
+functionality--see below), wherein the same block is used for several
+C<case> statements.
+
+=end original
+
+これはある意味 C スタイルの switch 文の次の条件への移動(fallthrough)機能と
+等価です(I<Perl の> 次の条件への移動機能と混同しないでください--
+後述します); 複数の C<case> 文に同じブロックが使われます。
+
+=begin original
+
+Another useful shortcut is that, if you use a literal array or hash as the
+argument to C<given>, it is turned into a reference. So C<given(@foo)> is
+the same as C<given(\@foo)>, for example.
+
+=end original
+
+その他の便利な省略記法としては、C<given> の引数としてリテラルな配列や
+ハッシュを書くと、これはリファレンスに変化します。
+それで、例えば C<given(@foo)> は C<given(\@foo)> と同じです。
+
+=begin original
+
+C<default> behaves exactly like C<when(1 == 1)>, which is
+to say that it always matches.
+
+=end original
+
+C<default> は正確に C<when(1 == 1)> のように振る舞い、常に
+マッチングします。
+
+=head3 Breaking out
+
+(脱出)
+
+=begin original
+
+You can use the C<break> keyword to break out of the enclosing
+C<given> block. Every C<when> block is implicitly ended with
+a C<break>.
+
+=end original
+
+囲まれている C<given> ブロックから脱出するために、C<break> キーワードが
+使えます。
+全ての C<when> ブロックの末尾には暗黙に C<break> があります。
+
+=head3 Fall-through
+
+(次の条件への移動(Fall-through))
+
+=begin original
+
+You can use the C<continue> keyword to fall through from one
+case to the next:
+
+=end original
+
+一つの条件から次へ移動するためには、C<continue> キーワードが使えます:
+
+ given($foo) {
+ when (/x/) { say '$foo contains an x'; continue }
+ when (/y/) { say '$foo contains a y' }
+ default { say '$foo does not contain a y' }
+ }
+
+=head3 Return value
+
+(返り値)
+
+=begin original
+
+When a C<given> statement is also a valid expression (for example,
+when it's the last statement of a block), it evaluates to:
+
+=end original
+
+C<given> が有効な式でもある(例えばブロックの最後の文である)場合、
+以下のように評価されます:
+
+=over 4
+
+=item *
+
+=begin original
+
+An empty list as soon as an explicit C<break> is encountered.
+
+=end original
+
+明示的な C<break> に遭遇した直後なら空リスト。
+
+=item *
+
+=begin original
+
+The value of the last evaluated expression of the successful
+C<when>/C<default> clause, if there happens to be one.
+
+=end original
+
+もし成功していれば、成功した C<when>/C<default> 節で最後に評価された式の値。
+
+=item *
+
+=begin original
+
+The value of the last evaluated expression of the C<given> block if no
+condition is true.
+
+=end original
+
+どの条件も真でなければ C<given> ブロックで最後に評価された式の値。
+
+=back
+
+=begin original
+
+In both last cases, the last expression is evaluated in the context that
+was applied to the C<given> block.
+
+=end original
+
+最後の二つの場合、最後の式は適用された C<given> ブロックに適用された
+コンテキストで評価されます。
+
+=begin original
+
+Note that, unlike C<if> and C<unless>, failed C<when> statements always
+evaluate to an empty list.
+
+=end original
+
+C<if> や C<unless> と異なり、失敗した C<when> 文は常に空リストに
+評価されます。
+
+ my $price = do {
+ given ($item) {
+ when (["pear", "apple"]) { 1 }
+ break when "vote"; # My vote cannot be bought
+ 1e10 when /Mona Lisa/;
+ "unknown";
+ }
+ };
+
+=begin original
+
+Currently, C<given> blocks can't always
+be used as proper expressions. This
+may be addressed in a future version of Perl.
+
+=end original
+
+現在のところ、C<given> ブロックは常に適切な式として使うことはできません。
+これは将来のバージョンの Perl に対処されるでしょう。
+
+=head3 Switching in a loop
+
+(ループ内の switch)
+
+=begin original
+
+Instead of using C<given()>, you can use a C<foreach()> loop.
+For example, here's one way to count how many times a particular
+string occurs in an array:
+
+=end original
+
+C<given()> を使う代わりに、C<foreach()> ループを使えます。
+たとえば、以下は配列内に特定の文字列が何回現れるかを数えるための
+ひとつの方法です:
+
+ use v5.10.1;
+ my $count = 0;
+ for (@array) {
+ when ("foo") { ++$count }
+ }
+ print "\@array contains $count copies of 'foo'\n";
+
+=begin original
+
+Or in a more recent version:
+
+=end original
+
+あるいはより最近のバージョンでは:
+
+ use v5.14;
+ my $count = 0;
+ for (@array) {
+ ++$count when "foo";
+ }
+ print "\@array contains $count copies of 'foo'\n";
+
+=begin original
+
+At the end of all C<when> blocks, there is an implicit C<next>.
+You can override that with an explicit C<last> if you're
+interested in only the first match alone.
+
+=end original
+
+C<when> ブロックの末尾に、暗黙の C<next> があります。
+もし最初のマッチングだけに興味があるなら、明示的な C<last> でこれを
+上書きできます。
+
+=begin original
+
+This doesn't work if you explicitly specify a loop variable, as
+in C<for $item (@array)>. You have to use the default variable C<$_>.
+
+=end original
+
+これは、C<for $item (@array)> のように明示的にループ変数を指定した場合は
+動作しません。
+デフォルト変数 C<$_> を使う必要があります。
+
+=head3 Differences from Perl 6
+
+(Perl 6 からの違い)
+
+=begin original
+
+The Perl 5 smartmatch and C<given>/C<when> constructs are not compatible
+with their Perl 6 analogues. The most visible difference and least
+important difference is that, in Perl 5, parentheses are required around
+the argument to C<given()> and C<when()> (except when this last one is used
+as a statement modifier). Parentheses in Perl 6 are always optional in a
+control construct such as C<if()>, C<while()>, or C<when()>; they can't be
+made optional in Perl 5 without a great deal of potential confusion,
+because Perl 5 would parse the expression
+
+=end original
+
+Perl 5 のスマートマッチングと C<given>/C<when> 構文は Perl 6 のものと
+互換性はありません。
+もっとも目に見えて、もっとも重要でない違いは、Perl 5 では、C<given()> と
+C<when()> の引数は (後者を文修飾子として使う場合を除いて)かっこでくくる
+必要があります。
+Perl 6 では、C<if()>, C<while()>, C<when()> のような制御構造での
+かっこは常に省略可能です;
+Perl 5 では、潜在的な大混乱と引き換えにしなければこれを省略できません;
+なぜなら Perl 5 は以下のような表現において:
+
+ given $foo {
+ ...
+ }
+
+=begin original
+
+as though the argument to C<given> were an element of the hash
+C<%foo>, interpreting the braces as hash-element syntax.
+
+=end original
+
+C<given> の引数はハッシュ C<%foo> の要素であるかのようにパースして、
+中かっこをハッシュ要素文法として解釈するからです。
+
+=begin original
+
+However, their are many, many other differences. For example,
+this works in Perl 5:
+
+=end original
+
+しかし、ここにはとても多くのその他の違いがあります。
+例えば、これは Perl 5 で動作します:
+
+ use v5.12;
+ my @primary = ("red", "blue", "green");
+
+ if (@primary ~~ "red") {
+ say "primary smartmatches red";
+ }
+
+ if ("red" ~~ @primary) {
+ say "red smartmatches primary";
+ }
+
+ say "that's all, folks!";
+
+=begin original
+
+But it doesn't work at all in Perl 6. Instead, you should
+use the (parallelizable) C<any> operator:
+
+=end original
+
+しかしこれは Perl 6 では全く動作しません。
+代わりに、(並列化可能な) C<any> 演算子を使います:
+
+ if any(@primary) eq "red" {
+ say "primary smartmatches red";
+ }
+
+ if "red" eq any(@primary) {
+ say "red smartmatches primary";
+ }
+
+=begin original
+
+The table of smartmatches in L<perlop/"Smartmatch Operator"> is not
+identical to that proposed by the Perl 6 specification, mainly due to
+differences between Perl 6's and Perl 5's data models, but also because
+the Perl 6 spec has changed since Perl 5 rushed into early adoption.
+
+=end original
+
+L<perlop/"Smartmatch Operator"> のスマートマッチングの表は Perl 6 仕様で
+提案されれているものと同一ではありません; 主に Perl 6 と Perl 5 の
+データモデルの違いによりますが、Perl 6 の仕様は Perl 5 が早期に採用した
+後に変更されたからです。
+
+=begin original
+
+In Perl 6, C<when()> will always do an implicit smartmatch with its
+argument, while in Perl 5 it is convenient (albeit potentially confusing) to
+suppress this implicit smartmatch in various rather loosely-defined
+situations, as roughly outlined above. (The difference is largely because
+Perl 5 does not have, even internally, a boolean type.)
+
+=end original
+
+Perl 6 では、C<when()> は常にその引数に対する暗黙のスマートマッチングを
+行いますが、Perl 5 では既に大まかに示した通り、ゆるく定義された状況によっては
+暗黙のスマートマッチングを抑制したほうが便利(たとえ混乱させるかも
+知れないにしても)です。
+(主な違いは、Perl 5 は内部的にさえ真偽値型を持たないことによります。)
+
+=cut
+
+=begin meta
+
+Translate: KIMURA Koichi (5.005_03)
+Update: SHIRAKATA Kentaro <argra****@ub32*****> (5.8.8-)
+Status: completed
+
+=end meta
+