perl/5.34.0/perlsyn.pod


=encoding utf8

=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 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).  See
L<perldata/Scalar values> for definitions of true and false.

=end original

C<if> は I<もし> 条件が真の場合にのみ文を実行します。
C<unless> は逆で、条件が真 I<でない限り> (つまり、条件が偽なら) 文を
実行します。
真と偽の定義については L<perldata/Scalar values> を参照してください。

    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).
There is no syntax to specify a C-style for loop or a lexically scoped
iteration variable in this form.

=end original

C<for(each)> 修飾子は反復子です:
LIST の値それぞれ毎に文を実行します(実行中は C<$_> がそれぞれの値の
エイリアスとなります)。
この形式で C 風のループやレキシカルスコープの繰り返し変数を
指定する文法はありません。

    print "Hello $_!\n" for qw(world Dolly nurse);

=begin original

C<while> repeats the statement I<while> the condition is true.
Postfix C<while> has the same magic treatment of some kinds of condition
that prefix C<while> has.
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<while> は、ある種の条件において、前置 C<while> と同じ
マジカルな処理をします。
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>/C<redo>) or around it (for C<last>) to do that sort of thing.
X<next> X<last> X<redo>

=end original

L<perlfunc/do> を参照してください。
後述するループの制御文は、修飾子がループラベルを取らないために
この構造文では I<動作しない> ということにも注意してください。
申し訳ない。
こういった場合に対処するのに別のブロックを内側に入れたり(C<next> の場合)、
別のブロックで囲む(C<last>/C<redo> の場合)という方法が常に使えます。
X<next> X<last> X<redo>

=begin original

For C<next> or C<redo>, just double the braces:

=end original

C<next> や C<redo> では単に中かっこを二重にします:

    do {{
        next if $x == $y;
        # do something here
    }} until $x++ > $z;

=begin original

For C<last>, you have to be more elaborate and put braces around it:
X<last>

=end original

C<last> の場合は、もっと念入りにする必要があり、中かっこで囲みます:

    {
        do {
            last if $x == $y**2;
            # do something here
        } while $x++ <= $z;
    }

=begin original

If you need both C<next> and C<last>, you have to do both and also use a
loop label:

=end original

C<next> と C<last> の両方が必要な場合、両方を使ってさらにループラベルを
使う必要があります:

    LOOP: {
        do {{
            next if $x == $y;
            last LOOP if $x == $y**2;
            # do something here
        }} until $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 restriction 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.  Because enclosing
braces are also the syntax for hash reference constructor expressions
(see L<perlref>), you may occasionally need to disambiguate by placing a
C<;> immediately after an opening brace so that Perl realises the brace
is the start of a block.  You will more frequently need to disambiguate
the other way, by placing a C<+> immediately before an opening brace to
force it to be interpreted as a hash reference constructor expression.
It is considered good style to use these disambiguating mechanisms
liberally, not only when Perl would otherwise guess incorrectly.

=end original

しかし一般的には、ブロックは中かっこによって範囲が定められます。
この構文的な構造をブロックと呼びます。
中かっこによる囲みはハッシュリファレンス初期化表現 (L<perlref> 参照) の
文法でもあるので、中かっこがブロックの開始であることを Perl が分かるように、
時々開き中かっこの直後に C<;> を置くことで曖昧さをなくす
必要があるかもしれません。
より頻繁には、ハッシュリファレンス初期化表現として解釈されることを
強制するために、開き中かっこの直前に C<+> を置くことで逆方向に
曖昧さをなくす必要があるかも知れません。
これらのあいまいさをなくす機構は、Perl が間違って推測するときだけではなく、
より安全に使うのがよいスタイルと考えられています。

=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

If enabled by the experimental C<try> feature, the following may also be used

=end original

実験的な C<try> 機能によって有効の場合、次のものも使えます:

    try BLOCK catch (VAR) 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
true.
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
searching through 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> 文は、式が真である間、ブロックを実行します。
C<until> 文は、式が偽である間、ブロックを実行します。
LABEL は省略可能ですが、ある場合には、コロンを伴った識別子になります。
LABEL は C<next>、C<last>、C<redo> といったループ制御文のループを規定します。
LABEL が省略された場合、ループ制御文はそれを含むループの中で最も内側の
ループを参照します。
これは、実行時に LABEL を検出するための呼び出しスタックを動的に検索することを
含むことができます。
そのような推奨されない振る舞いは、C<use warnings> プラグマや B<-w> フラグを
使った場合には警告を引き起こします。

=begin original

If the condition expression of a C<while> statement is based
on any of a group of iterative expression types then it gets
some magic treatment.  The affected iterative expression types
are L<C<readline>|perlfunc/readline EXPR>, the L<C<< <FILEHANDLE>
>>|perlop/"I/O Operators"> input operator, L<C<readdir>|perlfunc/readdir
DIRHANDLE>, L<C<glob>|perlfunc/glob EXPR>, the L<C<< <PATTERN>
>>|perlop/"I/O Operators"> globbing operator, and L<C<each>|perlfunc/each
HASH>.  If the condition expression is one of these expression types, then
the value yielded by the iterative operator will be implicitly assigned
to C<$_>.  If the condition expression is one of these expression types
or an explicit assignment of one of them to a scalar, then the condition
actually tests for definedness of the expression's value, not for its
regular truth value.

=end original

C<while> 文の条件式が反復式型のグループの一つの場合、
マジカルな扱いを受けます。
影響を受ける反復式型は、
L<C<readline>|perlfunc/readline EXPR>、L<C<< <FILEHANDLE>
>>|perlop/"I/O Operators"> 入力反復子、L<C<readdir>|perlfunc/readdir
DIRHANDLE>、L<C<glob>|perlfunc/glob EXPR>、L<C<< <PATTERN>
>>|perlop/"I/O Operators"> グロブ演算子、L<C<each>|perlfunc/each
HASH> です。
条件式がこれらの式の型の一つの場合、反復演算子によって
取り出された値は暗黙に C<$_> に代入されます。
条件式がこれらの式の型の一つか、これらの一つからスカラへの明示的な代入の
場合、条件は実際には通常の真の値かどうかではなく、式の値が
定義値かどうかをテストします。

=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 preceded 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).  To illustrate:
X<my>

=end original

小さな違いが一つあります: C<for> の初期化部で C<my> を使って変数が
宣言された場合、この変数のレキシカルスコープは C<for> ループ
(ループ本体と制御部) と完全に同じです。
図示すると:
X<my>

    my $i = 'samba';
    for (my $i = 1; $i <= 4; $i++) {
        print "$i\n";
    }
    print "$i\n";

=begin original

when executed, gives:

=end original

実行すると、次のものになります:

    1
    2
    3
    4
    samba

=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

The condition expression of a C<for> loop gets the same magic treatment of
C<readline> et al that the condition expression of a C<while> loop gets.

=end original

C<for> ループの条件式は、C<while> ループの条件式で行われるものと同様、
C<readline> のマジカルな扱いが行われます。

=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-style C<for> loop.

=end original

どのくらいこれが簡単になったように見えますか?
これは明確で、安全で、高速です。
これは余計なものが少ないので明確なのです。
これは後で内側のループと外側のループとの間にコードを付加えた場合でも、
それを間違って実行することがないので安全なのです。
C<next> は内側のループを終了するのではなく、外側のループの繰り返しを
行います。
そしてこれは、Perl は C<foreach> 文をそれと等価な C 形式の 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 Try Catch Exception Handling
X<try> X<catch>

=begin original

The C<try>/C<catch> syntax provides control flow relating to exception
handling. The C<try> keyword introduces a block which will be executed when it
is encountered, and the C<catch> block provides code to handle any exception
that may be thrown by the first.

=end original

C<try>/C<catch> 構文は、例外処理に関連する制御フローを提供します。
C<try> キーワードは、それが検出されたときに実行されるブロックを導入し、
C<catch> ブロックは、最初のものによって投げられる可能性のある例外を
処理するコードを提供します。

    try {
        my $x = call_a_function();
        $x < 100 or die "Too big";
        send_output($x);
    }
    catch ($e) {
        warn "Unable to output a value; $e";
    }
    print "Finished\n";

=begin original

Here, the body of the C<catch> block (i.e. the C<warn> statement) will be
executed if the initial block invokes the conditional C<die>, or if either of
the functions it invokes throws an uncaught exception. The C<catch> block can
inspect the C<$e> lexical variable in this case to see what the exception was.
If no exception was thrown then the C<catch> block does not happen. In either
case, execution will then continue from the following statement - in this
example the C<print>.

=end original

ここで、C<catch> ブロックの本体 (つまり、C<warn> 文) は、最初の
ブロックが条件付き C<die> を呼び出した場合、または呼び出した関数のいずれかが
捕捉されない例外を投げた場合に実行されます。
C<catch> ブロックは、この場合の C<$e> レキシカル変数を検査して、例外が何かを
調べることができます。
例外が投げられなかった場合、C<catch> ブロックは発生しません。
いずれの場合も、次の文 (この例では C<print>) から実行が続行されます。

=begin original

The C<catch> keyword must be immediately followed by a variable declaration in
parentheses, which introduces a new variable visible to the body of the
subsequent block. Inside the block this variable will contain the exception
value that was thrown by the code in the C<try> block. It is not necessary
to use the C<my> keyword to declare this variable; this is implied (similar
as it is for subroutine signatures).

=end original

C<catch> キーワードの直後には、かっこで囲まれた変数宣言が
続かなければなりません;
これにより、後続のブロックの本文から見える新しい変数が導入されます。
ブロック内では、この変数には、C<try> ブロック内のコードによって投げられた
例外値が含まれます。
この変数を宣言するために C<my> キーワードを使用する必要はありません;
これは(サブルーチンシグネチャの場合と同様)暗黙的です。

=begin original

Both the C<try> and the C<catch> blocks are permitted to contain control-flow
expressions, such as C<return>, C<goto>, or C<next>/C<last>/C<redo>. In all
cases they behave as expected without warnings. In particular, a C<return>
expression inside the C<try> block will make its entire containing function
return - this is in contrast to its behaviour inside an C<eval> block, where
it would only make that block return.

=end original

C<try> ブロックと C<catch> ブロックの両方に、C<return>, C<goto>,
C<next>/C<last>/C<redo> などの制御フロー式を含めることができます。
いずれの場合も、警告なしに想定通りに動作します。
特に、C<try> ブロック内の C<return> 式は、それを含む関数全体から返ります -
これは、そのブロックからのみ返る C<eval> ブロック内での動作とは対照的です。

=begin original

Like other control-flow syntax, C<try> and C<catch> will yield the last
evaluated value when placed as the final statement in a function or a C<do>
block. This permits the syntax to be used to create a value. In this case
remember not to use the C<return> expression, or that will cause the
containing function to return.

=end original

他の制御フロー構文と同様に、C<try> と C<catch> は、関数または C<do>
ブロックの最後のステートメントとして配置された場合に、最後に評価された値を
生成します。
これにより、この構文を使用して値を作成できます。
この場合、C<return> 式を使用しないでください;
使用すると、含まれる関数から戻ることになります。

    my $value = do {
        try {
            get_thing(@args);
        }
        catch ($e) {
            warn "Unable to get thing - $e";
            $DEFAULT_THING;
        }
    };

=begin original

As with other control-flow syntax, C<try> blocks are not visible to
C<caller()> (just as for example, C<while> or C<foreach> loops are not).
Successive levels of the C<caller> result can see subroutine calls and
C<eval> blocks, because those affect the way that C<return> would work. Since
C<try> blocks do not intercept C<return>, they are not of interest to
C<caller>.

=end original

他の制御フロー構文と同様に、C<try> ブロックは C<caller()> には見えません
(例えば、C<while> または C<foreach> ループが見えないのと同様です)。
C<caller> の結果の連続するレベルは、サブルーチン呼び出しと C<eval> ブロックを
見ることができます; なぜなら、それらは C<return> の動作方法に
影響するからです。
C<try> ブロックは C<return> に割り込まないので、それらは
C<caller> には関係ありません。

=begin original

This syntax is currently experimental and must be enabled with
C<use feature 'try'>. It emits a warning in the C<experimental::try> category.

=end original

この構文は現在実験的であり、C<use feature 'try'> を使用して有効にする
必要があります。
C<experimental::try> カテゴリの警告を出力します。

=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 Raku proposal, but it no longer resembles the Raku
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 機能を有効にします。
これはおおまかに Raku 提案の古い版を基にしていますが、もはや
Raku の構文と共通点はありません。
コードが 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 -- though C<continue> is not -- 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<continue> は違いますが --
他の言語での 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 Raku language
specification.  This bug was fixed in Perl 5.18 (and lexicalized C<$_> itself
was removed in Perl 5.24).

=end original

Perl 5.10 と 5.14 の間での C<given> の実装方法による不幸なバグにより、
現在の実装では、C<given> によって管理される C<$_> は、
C<foreach> の場合やオリジナルと現在両方の Raku 言語仕様のように
元のものの動的スコープな別名ではなく、単なるレキシカルスコープのコピーです。
このバグは Perl 5.18 で修正されました
(そしてレキシカルな C<$_> 自身は Perl 5.24 で削除されました)。

=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.
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 から、Perl はまだ実装していないコードのプレースホルダとして
省略 "C<...>" を受け付けるようになりました。
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.  Syntactically, "C<...;>" is a complete statement, but,
as with other kinds of semicolon-terminated statement, the semicolon
may be omitted if "C<...>" appears immediately before a closing brace.
These examples show how the ellipsis works:

=end original

完全な文を使える場所でのみ省略文を使えます。
文法的には、"C<...;>" は完全な文ですが、その他のセミコロン終端する
文と同様、"C<...>" が閉じ中かっこの直前に現れる場合は、
セミコロンは省略できます。
次の例は省略がどのように動作するかの例です:

    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.
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" };
    ... if $a > $b;
    say "Cromulent" if ...;
    $flub = 5 + ...;

=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.
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.

=end original

式と文との違いをすぐに説明できない場合があります。
例えば、ブロックと無名ハッシュリファレンスのコンストラクタは、
Perl にヒントを与える中かっこがなければ同じに見えます。
省略文は Perl が C<{ ... }> をブロックと判断できなかった場合は
文法エラーとなります。
ブロックの中では、C<{ ... }> がブロックであってハッシュリファレンスの
コンストラクタでないことを示すために、省略の前に C<;> を使えます。

=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 frequently the 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 immediate C<when> or C<default>:

=end original

ある case から 直後の C<when> または C<default> に移動するために
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 Raku

(Raku からの違い)

=begin original

The Perl 5 smartmatch and C<given>/C<when> constructs are not compatible
with their Raku 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 Raku 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> 構文は Raku のものと
互換性はありません。
もっとも目に見えて、もっとも重要でない違いは、Perl 5 では、C<given()> と
C<when()> の引数は (後者を文修飾子として使う場合を除いて)かっこでくくる
必要があります。
Raku では、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 Raku.  Instead, you should
use the (parallelizable) C<any> operator:

=end original

しかしこれは Raku では全く動作しません。
代わりに、(並列化可能な)  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 Raku specification, mainly due to
differences between Raku's and Perl 5's data models, but also because
the Raku spec has changed since Perl 5 rushed into early adoption.

=end original

L<perlop/"Smartmatch Operator"> のスマートマッチングの表は Raku 仕様で
提案されれているものと同一ではありません; 主に Raku と Perl 5 の
データモデルの違いによりますが、Raku の仕様は Perl 5 が早期に採用した
後に変更されたからです。

=begin original

In Raku, 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

Raku では、C<when()> は常にその引数に対する暗黙のスマートマッチングを
行いますが、Perl 5 では既に大まかに示した通り、ゆるく定義された状況によっては
暗黙のスマートマッチングを抑制したほうが便利(たとえ混乱させるかも
知れないにしても)です。
(主な違いは、Perl 5 は内部的にさえ真偽値型を持たないことによります。)

=cut

=begin meta

Translate: KIMURA Koichi (5.005_03)
Update: SHIRAKATA Kentaro <argrath@ub32.org> (5.8.8-)
Status: completed

=end meta
