5.22.1

名前

perlport - Writing portable Perl

perlport - 移植性のある Perl を書く

説明

Perl runs on numerous operating systems. While most of them share much in common, they also have their own unique features.

Perl は多くのオペレーティングシステム上で動作します。 これらのほとんどは一般的にかなりの部分を共有していますが、それぞれ固有の 機能も持っています。

This document is meant to help you to find out what constitutes portable Perl code. That way once you make a decision to write portably, you know where the lines are drawn, and you can stay within them.

この文書は移植性のある Perl コードの構成要素を発見する助けになるための ものです。 移植性のある形で書こうと決心したら、どこに線が引かれているかを知ることで、 その内側に留まることができます。

There is a tradeoff between taking full advantage of one particular type of computer and taking advantage of a full range of them. Naturally, as you broaden your range and become more diverse, the common factors drop, and you are left with an increasingly smaller area of common ground in which you can operate to accomplish a particular task. Thus, when you begin attacking a problem, it is important to consider under which part of the tradeoff curve you want to operate. Specifically, you must decide whether it is important that the task that you are coding has the full generality of being portable, or whether to just get the job done right now. This is the hardest choice to be made. The rest is easy, because Perl provides many choices, whichever way you want to approach your problem.

ある特定の種類のコンピュータの利点を使うことと、あらゆる範囲の コンピュータの利点を使うことの間にはトレードオフがあります。 当然ながら、より範囲を広げてより多様性のある形にすると、共通の要素が 減っていき、特定のタスクを達成するために操作できる共通の地盤が徐々に 小さくなっていきます。 従って、問題に取りかかるときに、トレードオフのカーブのどの部分を 使うかを考えることは重要です。 特に、コーディングしようとするタスクが移植性に関して完全な一般性が 重要かどうか、またすぐにジョブを終わらせるかどうかを 決定しなければなりません。 残りのことは簡単です。 なぜならあなたが問題にどのようにアプローチしたいとしても Perl は多くの 選択肢を提供するからです。

Looking at it another way, writing portable code is usually about willfully limiting your available choices. Naturally, it takes discipline and sacrifice to do that. The product of portability and convenience may be a constant. You have been warned.

これを他の方法で見てみると、移植性のあるコードを書くことは通常あなたが 取り得る選択肢を故意に制限します。 当然ながら、これは規律と犠牲が伴います。 おそらく移植性と利便性の積は一定です。 あなたは警告されましたよ。

Be aware of two important points:

二つの重要な点に注意してください:

Not all Perl programs have to be portable

(全ての Perl プログラムが移植性がある必要はありません)

There is no reason you should not use Perl as a language to glue Unix tools together, or to prototype a Macintosh application, or to manage the Windows registry. If it makes no sense to aim for portability for one reason or another in a given program, then don't bother.

Unix ツールを互いにくっつけたり、Macintosh アプリケーションのプロトタイプを 作ったり、Windows レジストリを操作するための言語として Perl を 使うべきではないという理由はありません。 プログラムにとって何らかの理由で移植性を目標とすることが無意味なら、 気にしないでください。

Nearly all of Perl already is portable

(ほとんど全ての Perl は既に移植性が あります)

Don't be fooled into thinking that it is hard to create portable Perl code. It isn't. Perl tries its level-best to bridge the gaps between what's available on different platforms, and all the means available to use those features. Thus almost all Perl code runs on any machine without modification. But there are some significant issues in writing portable code, and this document is entirely about those issues.

移植性のある Perl コードを作るのが難しいという考えに騙されないでください。 そうではありません。 Perl は、異なったプラットフォームで何が利用可能かとこの機能を使うために 利用可能なもの全てとの間のずれを出来るだけ橋渡ししようとします。 従って、ほとんど全ての Perl コードは修正なしにどのマシンでも動作します。 しかし移植性のあるコードを書くにはいくつかの重要な問題があり、この文書は 全体的にそのような問題を扱っています。

Here's the general rule: When you approach a task commonly done using a whole range of platforms, think about writing portable code. That way, you don't sacrifice much by way of the implementation choices you can avail yourself of, and at the same time you can give your users lots of platform choices. On the other hand, when you have to take advantage of some unique feature of a particular platform, as is often the case with systems programming (whether for Unix, Windows, VMS, etc.), consider writing platform-specific code.

一般的なルールを挙げます: プラットフォーム全体で使われて一般的に 処理されるようなタスクに迫るとき、移植性のあるコードを書くことを 考えてください。 その方向で、自分自身の実装の選択肢を多く犠牲にすることはなく、 同時にユーザーに多くのプラットフォームの選択肢を与えることができます。 一方、特定のプラットフォームで固有の機能の利点を使う必要がある場合、 例えば (Unix, Windows, VMS など専用の) システムプログラムのような 場合、プラットフォーム固有のコードを書くことを考えてください。

When the code will run on only two or three operating systems, you may need to consider only the differences of those particular systems. The important thing is to decide where the code will run and to be deliberate in your decision.

コードが二つか三つのオペレーティングシステムでだけ動作するときは、 それらの特定のシステムでの違いのみを考慮する必要があります。 重要なことは、どこでコードを実行するかと、決定を熟考することです。

The material below is separated into three main sections: main issues of portability ("ISSUES"), platform-specific issues ("PLATFORMS"), and built-in Perl functions that behave differently on various ports ("FUNCTION IMPLEMENTATIONS").

以下の材料は三つの主な章に分割されています: 主な移植性の問題 ("ISSUES")、プラットフォーム固有の問題 ("PLATFORMS")、 OS によって異なった振る舞いをする Perl 組み込み関数 ("FUNCTION IMPLEMENTATIONS") です。

This information should not be considered complete; it includes possibly transient information about idiosyncrasies of some of the ports, almost all of which are in a state of constant evolution. Thus, this material should be considered a perpetual work in progress (<IMG SRC="yellow_sign.gif" ALT="Under Construction">).

この情報は完全であると考えるべきではありません; これは一部の OS に対する 特異性に関するおそらく一時的な情報を含んでいて、それらのほとんどは常に 進化しているものです。 従って、この材料は永遠に作業中であると考えるべきです (<IMG SRC="yellow_sign.gif" ALT="Under Construction">)。

問題

改行

In most operating systems, lines in files are terminated by newlines. Just what is used as a newline may vary from OS to OS. Unix traditionally uses \012, one type of DOSish I/O uses \015\012, Mac OS uses \015, and z/OS uses \025.

ほとんどのオペレーティングシステムで、ファイルの行は改行で終端されます。 単に改行として何を使うかが OS によって異なります。 Unix は伝統的に \012 を使い、DOS 風の I/O は \015\012 を使い、 Mac OS\015 を使い、z/OS は \025 を使います。

Perl uses \n to represent the "logical" newline, where what is logical may depend on the platform in use. In MacPerl, \n always means \015. On EBCDIC platforms, \n could be \025 or \045. In DOSish perls, \n usually means \012, but when accessing a file in "text" mode, perl uses the :crlf layer that translates it to (or from) \015\012, depending on whether you're reading or writing. Unix does the same thing on ttys in canonical mode. \015\012 is commonly referred to as CRLF.

Perl は「論理的な」改行を表現するのに \n を使います; 何が論理的かは 使っているプラットフォームに依存しています。 MacPerl では \n は常に \015 を意味します。 EBCDIC プラットフォームでは、\n\025 または \045 です。 DOS 風の perl では、\n は普通 \012 を意味しますが、ファイルを 「テキスト」モードでアクセスすると、perl は \015\012 との間で 変換する :crlf を使います。 Unix はカノニカルモードの tty で同じことをします。 \015\012 は一般的には CRLF として参照されます。

To trim trailing newlines from text lines use chomp(). With default settings that function looks for a trailing \n character and thus trims in a portable way.

テキスト行から末尾の改行を切り落とすには、chomp() を使います。 この関数のデフォルト設定は末尾の \n 文字を探すので、移植性のある形で 切り落とします。

When dealing with binary files (or text files in binary mode) be sure to explicitly set $/ to the appropriate value for your file format before using chomp().

バイナリファイル (またはバイナリモードでのテキストファイル) を扱うときには、 chomp() を使う前にファイル形式に適切な値を $/ に明示的に設定してください。

Because of the "text" mode translation, DOSish perls have limitations in using seek and tell on a file accessed in "text" mode. Stick to seek-ing to locations you got from tell (and no others), and you are usually free to use seek and tell even in "text" mode. Using seek or tell or other file operations may be non-portable. If you use binmode on a file, however, you can usually seek and tell with arbitrary values safely.

「テキスト」モード変換によって、DOS 的な perl は「テキスト」モードで アクセスするファイルに対する seektell の使用に制限があります。 tell で得た位置へ seek する(そして他の方法を使わない)ことに 専念することで、「テキスト」モードでも自由に seektell を 使えます。 seektell やその他のファイル操作は互換性がないかもしれません。 しかし、ファイルに対して binmode を使うと、普通は任意の値を seektell に使っても安全です。

A common misconception in socket programming is that \n eq \012 everywhere. When using protocols such as common Internet protocols, \012 and \015 are called for specifically, and the values of the logical \n and \r (carriage return) are not reliable.

ソケットプログラミングでのよくある誤解は、どこでも \n eq \012 であると いうものです。 一般的なインターネットプロトコルのようなプロトコルを使うとき、 \012\015 は明確に記述されていて、論理的な \n\r (復帰) の値は信頼できません。

    print SOCKET "Hi there, client!\r\n";      # WRONG
    print SOCKET "Hi there, client!\015\012";  # RIGHT

However, using \015\012 (or \cM\cJ, or \x0D\x0A) can be tedious and unsightly, as well as confusing to those maintaining the code. As such, the Socket module supplies the Right Thing for those who want it.

しかし、\015\012 (または \cM\cJ または \x0D\x0A) を使うのは 退屈で見苦しいかもしれませんし、コードの保守に混乱するかもしれません。 そのようなものとして、Socket モジュールは求められていることに対する 正しいものを供給します。

    use Socket qw(:DEFAULT :crlf);
    print SOCKET "Hi there, client!$CRLF"      # RIGHT

When reading from a socket, remember that the default input record separator $/ is \n, but robust socket code will recognize as either \012 or \015\012 as end of line:

ソケットから読み込むとき、デフォルト入力レコード区切り $/\n だけれども、堅牢なソケットコードは \012\015\012 の どちらも行の末尾として認識することを忘れないでください:

    while (<SOCKET>) {  # NOT ADVISABLE!
        # ...
    }

Because both CRLF and LF end in LF, the input record separator can be set to LF and any CR stripped later. Better to write:

CRLF と LF は両方とも LF で終わっているので、入力レコード区切りを LF に設定して、後から CR を削除できます。 よりよく書くと:

    use Socket qw(:DEFAULT :crlf);
    local($/) = LF;      # not needed if $/ is already \012

    while (<SOCKET>) {
        s/$CR?$LF/\n/;   # not sure if socket uses LF or CRLF, OK
    #   s/\015?\012/\n/; # same thing
    }

This example is preferred over the previous one--even for Unix platforms--because now any \015's (\cM's) are stripped out (and there was much rejoicing).

この例は -- 例え Unix プラットフォームでも -- 以前のものよりよいものです; なぜなら全ての \015 (\cM) が削除される(そしてこれはとても喜ばしい) からです。

Similarly, functions that return text data--such as a function that fetches a web page--should sometimes translate newlines before returning the data, if they've not yet been translated to the local newline representation. A single line of code will often suffice:

同様に、-- web ページを取得する関数のような -- テキストデータを返す関数は、 まだローカルな改行表現に変換されていないなら、データを返す前に改行を 変換するべき場合もあります。 しばしば 1 行のコードで十分です:

    $data =~ s/\015?\012/\n/g;
    return $data;

Some of this may be confusing. Here's a handy reference to the ASCII CR and LF characters. You can print it out and stick it in your wallet.

これらには混乱があるかもしれません。 以下は ASCII CR と LF 文字の便利なリファレンスです。 これを印刷して財布に貼ることができます。

    LF  eq  \012  eq  \x0A  eq  \cJ  eq  chr(10)  eq  ASCII 10
    CR  eq  \015  eq  \x0D  eq  \cM  eq  chr(13)  eq  ASCII 13

             | Unix | DOS  | Mac  |
        ---------------------------
        \n   |  LF  |  LF  |  CR  |
        \r   |  CR  |  CR  |  LF  |
        \n * |  LF  | CRLF |  CR  |
        \r * |  CR  |  CR  |  LF  |
        ---------------------------
        * text-mode STDIO

The Unix column assumes that you are not accessing a serial line (like a tty) in canonical mode. If you are, then CR on input becomes "\n", and "\n" on output becomes CRLF.

Unix の列は、カノニカルモードで(tty のような)シリアルインターフェースに アクセスしているのではないことを仮定しています。 もしそうなら、入力の CR は "\n" になり、出力の "\n" は CRLF になります。

These are just the most common definitions of \n and \r in Perl. There may well be others. For example, on an EBCDIC implementation such as z/OS (OS/390) or OS/400 (using the ILE, the PASE is ASCII-based) the above material is similar to "Unix" but the code numbers change:

これらは単に Perl でのもっとも一般的な \n\r の定義です。 他のものもあり得ます。 例えば、z/OS (OS/390) や OS/400 (ILE を使っている場合; PASE は ASCII ベース) のような EBCDIC 実装では、上述の資料は "Unix" と同様ですが、 コード番号が変更されます:

    LF  eq  \025  eq  \x15  eq  \cU  eq  chr(21)  eq  CP-1047 21
    LF  eq  \045  eq  \x25  eq           chr(37)  eq  CP-0037 37
    CR  eq  \015  eq  \x0D  eq  \cM  eq  chr(13)  eq  CP-1047 13
    CR  eq  \015  eq  \x0D  eq  \cM  eq  chr(13)  eq  CP-0037 13

             | z/OS | OS/400 |
        ----------------------
        \n   |  LF  |  LF    |
        \r   |  CR  |  CR    |
        \n * |  LF  |  LF    |
        \r * |  CR  |  CR    |
        ----------------------
        * text-mode STDIO

数値のエンディアンと幅

Different CPUs store integers and floating point numbers in different orders (called endianness) and widths (32-bit and 64-bit being the most common today). This affects your programs when they attempt to transfer numbers in binary format from one CPU architecture to another, usually either "live" via network connection, or by storing the numbers to secondary storage such as a disk file or tape.

CPU が異なると、整数と浮動小数点数の順序 (エンディアン (endianness) と 呼ばれます) と幅 (最近ではほとんど 32 ビットと 64 ビットです) が異なります。 これは、ある CPU アーキテクチャから他のものへ数値をバイナリ形式で、 普通はネットワーク接続経由で「ライブ」で、またはディスクファイルや テープのような二次ストレージに保管することで移そうとしたときに 影響します。

Conflicting storage orders make an utter mess out of the numbers. If a little-endian host (Intel, VAX) stores 0x12345678 (305419896 in decimal), a big-endian host (Motorola, Sparc, PA) reads it as 0x78563412 (2018915346 in decimal). Alpha and MIPS can be either: Digital/Compaq used/uses them in little-endian mode; SGI/Cray uses them in big-endian mode. To avoid this problem in network (socket) connections use the pack and unpack formats n and N, the "network" orders. These are guaranteed to be portable.

保管の順序が衝突すると値が完全におかしくなります。 リトルエンディアンのホスト (Intel, VAX) が 0x12345678 (10 進数では 305419896) を保管すると、ビッグエンディアンのホスト (Motorola, Sparc, PA) は これを 0x78563412 (10 進数では 2018915346) として読み込みます。 Alpha と MIPS はどちらもあり得ます: Digital/Compaq はこれを リトルエンティアンモードで使います; SGI/Cray はこれを ビッグエンディアンモードで使います。 ネットワーク(ソケット)接続でこの問題を避けるには、packunpack の 「ネットワーク」順序フォーマットである n および N を使ってください。 これらは移植性があることを保証します。

As of Perl 5.10.0, you can also use the > and < modifiers to force big- or little-endian byte-order. This is useful if you want to store signed integers or 64-bit integers, for example.

Perl 5.10.0 から、ビッグエンディアンとリトルエンディアンにバイト順を 強制するための >< の修飾子も使えます。 これは例えば、符号付き整数や 64 ビット整数を保管したいときに有用です。

You can explore the endianness of your platform by unpacking a data structure packed in native format such as:

次のように、ネイティブな形式で pack されたデータ構造を unpack することで プラットフォームのエンディアンを調べることができます:

    print unpack("h*", pack("s2", 1, 2)), "\n";
    # '10002000' on e.g. Intel x86 or Alpha 21064 in little-endian mode
    # '00100020' on e.g. Motorola 68040

If you need to distinguish between endian architectures you could use either of the variables set like so:

エンディアンアーキテクチャを区別する必要があるなら、以下のような変数の どちらかを使えます:

    $is_big_endian   = unpack("h*", pack("s", 1)) =~ /01/;
    $is_little_endian = unpack("h*", pack("s", 1)) =~ /^1/;

Differing widths can cause truncation even between platforms of equal endianness. The platform of shorter width loses the upper parts of the number. There is no good solution for this problem except to avoid transferring or storing raw binary numbers.

幅の違いは同じエンディアンのプラットフォームの間でも切り詰めを 引き起こすことがあります。 幅がより短い側のプラットフォームは数値の上位部分を失います。 生のバイナリ数値を転送したり保管したりしないようにする以外に、この問題への よい解決法はありません。

One can circumnavigate both these problems in two ways. Either transfer and store numbers always in text format, instead of raw binary, or else consider using modules like Data::Dumper and Storable (included as of Perl 5.8). Keeping all data as text significantly simplifies matters.

これらの問題は二つの方法で避けることが出来ます。 数値を常に生のバイナリではなくテキスト形式で転送して保管するか、(Perl 5.8 から含まれている) Data::DumperStorable のようなモジュールを 使うことを考慮します。 全てのデータをテキストで扱うことは問題をかなり単純化します。

The v-strings are portable only up to v2147483647 (0x7FFF_FFFF), that's how far EBCDIC, or more precisely UTF-EBCDIC will go.

v-文字列は v2147483647 (0x7FFF_FFFF) 以下でのみ移植性があります; これは EBCDIC、より正確には UTF-EBCDIC よりも遙かに遠いです。

ファイルとファイルシステム

Most platforms these days structure files in a hierarchical fashion. So, it is reasonably safe to assume that all platforms support the notion of a "path" to uniquely identify a file on the system. How that path is really written, though, differs considerably.

最近のほとんどのプラットフォームではファイルの構造は階層的です。 従って、全てのプラットフォームがシステム中のファイルをユニークに 識別するための「パス」記法に対応していると仮定することは合理的に安全です。 パスが実際にどのように書かれるかはかなり異なります。

Although similar, file path specifications differ between Unix, Windows, Mac OS, OS/2, VMS, VOS, RISC OS, and probably others. Unix, for example, is one of the few OSes that has the elegant idea of a single root directory.

似てはいるものの、ファイルパスの指定方法は Unix, Windows, Mac OS, OS/2, VMS, VOS, RISC OS そしておそらくその他で 異なります。 例えば、Unix は一つのルートディレクトリというエレガントな考え方を持つ 数少ない OS の一つです。

DOS, OS/2, VMS, VOS, and Windows can work similarly to Unix with / as path separator, or in their own idiosyncratic ways (such as having several root directories and various "unrooted" device files such NIL: and LPT:).

DOS, OS/2, VMS, VOS, Windows は / をパス区切りとして、(複数の ルートディレクトリや、NIL: や LPT: のような様々な「ルートでない」 デバイスファイルといった)独自の風変わりな方法で Unix と似たように 動作します。

Mac OS 9 and earlier used : as a path separator instead of /.

Mac OS 9 以前はパス区切りに / ではなく : を使います。

The filesystem may support neither hard links (link) nor symbolic links (symlink, readlink, lstat).

ファイルシステムはハードリンク (link) やシンボリックリンク (symlink, readlink, lstat) に対応していないかもしれません。

The filesystem may support neither access timestamp nor change timestamp (meaning that about the only portable timestamp is the modification timestamp), or one second granularity of any timestamps (e.g. the FAT filesystem limits the time granularity to two seconds).

ファイルシステムはアクセスタイムスタンプや変更タイムスタンプに 対応していないかもしれません (つまり移植性のあるタイムスタンプは 変更タイムスタンプだけです); またタイムスタンプは 1 秒単位では ないかもしれません (例えば、FAT ファイルシステムは時刻の単位は 2 秒単位です)。

The "inode change timestamp" (the -C filetest) may really be the "creation timestamp" (which it is not in Unix).

「inode 変更タイムスタンプ」 (-C ファイルテスト) は (Unix 以外では) 実際には「作成タイムスタンプ」かもしれません。

VOS perl can emulate Unix filenames with / as path separator. The native pathname characters greater-than, less-than, number-sign, and percent-sign are always accepted.

VOS perl は / をパス区切りとして Unix ファイル名をエミュレートできます。 ネイティブなパス名文字である大なり、小なり、シャープ、パーセントは常に 受け入れられます。

RISC OS perl can emulate Unix filenames with / as path separator, or go native and use . for path separator and : to signal filesystems and disk names.

RISC OS perl は / をパス区切りとして Unix ファイル名をエミュレート するか、ネイティブのままで . をパス区切り、: をファイルシステムと ディスクの名前として使えます。

Don't assume Unix filesystem access semantics: that read, write, and execute are all the permissions there are, and even if they exist, that their semantics (for example what do "r", "w", and "x" mean on a directory) are the Unix ones. The various Unix/POSIX compatibility layers usually try to make interfaces like chmod() work, but sometimes there simply is no good mapping.

Unix のファイルシステムアクセスの意味を仮定しないで下さい: 読み込み、 書き込み、実行のどれもです; たとえあったとしても、その意味論 (例えばディレクトリに対して "r", "w", "x" が何をするか) は Unix のものです。 様々な Unix/POSIX 互換層は普通 chmod() のようなものが動作するための インターフェースとなっていますが、ときどき単にいいマッピングが ないこともあります。

If all this is intimidating, have no (well, maybe only a little) fear. There are modules that can help. The File::Spec modules provide methods to do the Right Thing on whatever platform happens to be running the program.

もしこれら全てが怯えさせるものであるなら、恐れないでください(あー、多分 ほんの少しだけ恐れてください)。 助けになるモジュールがあります。 File::Spec モジュールはプログラムがどのプラットフォームで動作していても 「正しいこと」をします。

    use File::Spec::Functions;
    chdir(updir());        # go up one directory
    my $file = catfile(curdir(), 'temp', 'file.txt');
    # on Unix and Win32, './temp/file.txt'
    # on Mac OS Classic, ':temp:file.txt'
    # on VMS, '[.temp]file.txt'

File::Spec is available in the standard distribution as of version 5.004_05. File::Spec::Functions is only in File::Spec 0.7 and later, and some versions of Perl come with version 0.6. If File::Spec is not updated to 0.7 or later, you must use the object-oriented interface from File::Spec (or upgrade File::Spec).

File::Spec はバージョン 5.004_05 から標準配布で利用可能です。 File::Spec::FunctionsFile::Spec 0.7 以降のみにあり、一部の バージョンの Perl はバージョン 0.6 を含んでいます。 File::Spec が 0.7 以降に更新されていないなら、File::Spec の オブジェクト指向インターフェースを使わなければなりません (あるいは File::Spec を更新しなければなりません)。

In general, production code should not have file paths hardcoded. Making them user-supplied or read from a configuration file is better, keeping in mind that file path syntax varies on different machines.

一般的に、製品コードはファイルパスをハードコーディングするべきでは ありません。 ユーザーが指定できるようにするか、設定ファイルから読み込む方がよいです; ファイルパスの文法はマシンによって異なることを忘れないでください。

This is especially noticeable in scripts like Makefiles and test suites, which often assume / as a path separator for subdirectories.

これは、しばしば / がサブディレクトリのパス区切りと仮定されている Makefile やテストスイートのようなスクリプトで特に注意が必要です。

Also of use is File::Basename from the standard distribution, which splits a pathname into pieces (base filename, full path to directory, and file suffix).

もう一つの有用なものは標準配布に含まれている File::Basename で、これは パス名をベースファイル名、ディレクトリのフルパス、ファイルの拡張子に 分解します。

Even when on a single platform (if you can call Unix a single platform), remember not to count on the existence or the contents of particular system-specific files or directories, like /etc/passwd, /etc/sendmail.conf, /etc/resolv.conf, or even /tmp/. For example, /etc/passwd may exist but not contain the encrypted passwords, because the system is using some form of enhanced security. Or it may not contain all the accounts, because the system is using NIS. If code does need to rely on such a file, include a description of the file and its format in the code's documentation, then make it easy for the user to override the default location of the file.

単一のプラットフォームでさえ(Unix を単一のプラットフォームと呼ぶなら)、 /etc/passwd, /etc/sendmail.conf, /etc/resolv.conf あるいは /tmp/ でさえ、特定のシステム固有のファイルやディレクトリの存在や その内容を当てにできないことを忘れないでください。 例えば、/etc/passwd は存在するかもしれませんが、システムがある種の 強化されたセキュリティを使っているために、暗号化されたパスワードを 含んでいないかもしれません。 あるいは、NIS を使っているために、全てのアカウントを 含んでいないかもしれません。 コードがこのようなファイルに依存する必要がある場合、コードの文書に ファイルの説明とその形式を含めて、ユーザーがファイルのデフォルトの位置を 簡単に上書きできるようにします。

Don't assume a text file will end with a newline. They should, but people forget.

テキストファイルが改行で終わっていると仮定しないでください。 そうあるべきですが、人は忘れます。

Do not have two files or directories of the same name with different case, like test.pl and Test.pl, as many platforms have case-insensitive (or at least case-forgiving) filenames. Also, try not to have non-word characters (except for .) in the names, and keep them to the 8.3 convention, for maximum portability, onerous a burden though this may appear.

test.plTest.pl のような、大文字と小文字が違うだけの名前の二つの ファイルやディレクトリを作らないでください; 多くのプラットフォームは 大文字小文字を無視する(あるいは少なくとも大文字小文字に寛容な) ファイル名を持つからです。 また、最大限の互換性のため、起きるかも知れない厄介事のために、 (. 以外の)非単語文字を使わないようにして、8.3 の規約を維持してください。

Likewise, when using the AutoSplit module, try to keep your functions to 8.3 naming and case-insensitive conventions; or, at the least, make it so the resulting files have a unique (case-insensitively) first 8 characters.

同様に、AutoSplit モジュールを使う場合、関数の 8.3 の命名と大文字小文字を 無視する規約を維持するようにしてください; あるいは、少なくとも、 結果のファイルが最初の 8 文字が(大文字小文字を無視して)ユニークに なるようにしてください。

Whitespace in filenames is tolerated on most systems, but not all, and even on systems where it might be tolerated, some utilities might become confused by such whitespace.

ファイル名の空白はほとんどのシステムで許容されますが、全てではなく、 許容しているシステムでも、そのような空白によって混乱するユーティリティも あります。

Many systems (DOS, VMS ODS-2) cannot have more than one . in their filenames.

多くのシステム (DOS, VMS ODS-2) はファイル名に二つ以上の . を 使えません。

Don't assume > won't be the first character of a filename. Always use < explicitly to open a file for reading, or even better, use the three-arg version of open, unless you want the user to be able to specify a pipe open.

> がファイル名の最初の文字ではないと仮定しないでください。 ユーザーがパイプで開けるようにしたいのでない限り、読み込みのためにファイルを 開くときには常に明示的に < を使うか、もっとよいのは、3 引数版の open を使ってください。

    open my $fh, '<', $existing_file) or die $!;

If filenames might use strange characters, it is safest to open it with sysopen instead of open. open is magic and can translate characters like >, <, and |, which may be the wrong thing to do. (Sometimes, though, it's the right thing.) Three-arg open can also help protect against this translation in cases where it is undesirable.

もしファイル名におかしな文字が使われているかも知れないなら、 open ではなく sysopen を使って開くのがもっとも安全です。 open はマジカルで、>, <, | のような文字を 変換することがあり、これは間違ったことかもしれません。 (しかし、時々は、これは正しいことです。) 3 引数形式の open も予想していない状況でこの変換から守る助けになります。

Don't use : as a part of a filename since many systems use that for their own semantics (Mac OS Classic for separating pathname components, many networking schemes and utilities for separating the nodename and the pathname, and so on). For the same reasons, avoid @, ; and |.

: をファイル名の一部として使わないでください; 多くのシステムがこれを 独自の意味で使っているからです (Mac OS Classic はパス名要素を分割するために、 多くのネットワークスキームとユーティリティではノード名とパス名を 分割するために、など)。 同じ理由で、@, ;, | も避けてください。

Don't assume that in pathnames you can collapse two leading slashes // into one: some networking and clustering filesystems have special semantics for that. Let the operating system sort it out.

パス名の先頭の二つのスラッシュ // を一つに圧縮できると 仮定しないでください: ある種のネットワーキングとクラスタリングの ファイルシステムはこれに対して特別な意味論を持ちます。 オペレーティングシステムに任せてください。

The portable filename characters as defined by ANSI C are

ANSI C で定義されている、移植性のあるファイル名の文字 は:

 a b c d e f g h i j k l m n o p q r t u v w x y z
 A B C D E F G H I J K L M N O P Q R T U V W X Y Z
 0 1 2 3 4 5 6 7 8 9
 . _ -

and the "-" shouldn't be the first character. If you want to be hypercorrect, stay case-insensitive and within the 8.3 naming convention (all the files and directories have to be unique within one directory if their names are lowercased and truncated to eight characters before the ., if any, and to three characters after the ., if any). (And do not use .s in directory names.)

かつ "-" は最初の文字には使えません。 もし超完全にしたいなら、大文字小文字は無視して、8.3 命名規約に従います (全てのファイルとディレクトリは、名前を小文字にして、(もしあれば) . の 前の 8 文字と (もしあれば) . の後の 3 文字に切り詰めたときに、 ディレクトリ内でユニークである必要があります)。 (そしてディレクトリ名に . を使わないでください。)

システムの相互作用

Not all platforms provide a command line. These are usually platforms that rely primarily on a Graphical User Interface (GUI) for user interaction. A program requiring a command line interface might not work everywhere. This is probably for the user of the program to deal with, so don't stay up late worrying about it.

全てのプラットフォームがコマンドラインを提供しているわけではありません。 これらは普通ユーザーとの相互作用にグラフィカルユーザーインターフェース (GUI) に基本的に依存しています。 コマンドラインインターフェースを要求するプログラムはどこでも 動作するわけではありません。 これはおそらくプログラムを扱うユーザーの問題なので、心配して遅くまで 起きていないでください。

Some platforms can't delete or rename files held open by the system, this limitation may also apply to changing filesystem metainformation like file permissions or owners. Remember to close files when you are done with them. Don't unlink or rename an open file. Don't tie or open a file already tied or opened; untie or close it first.

一部のプラットフォームはシステムによって開かれているファイルを削除または リネームできません; この制限はファイル権限や所有者のような ファイルシステムのメタ情報の変更にも適用されることもあります。 ファイルに対する作業が終わったら、close することを忘れないでください。 開いているファイルに対して unlink または rename しないでください。 すでに tie されていたり開かれていたりするファイルに対して tieopen をしないで下さい; まず untie または close してください。

Don't open the same file more than once at a time for writing, as some operating systems put mandatory locks on such files.

同じファイルを同時に 2 回以上書き込みのために開いてはいけません; 一部のオペレーティングシステムはそのようなファイルに排他的ロックを掛けます。

Don't assume that write/modify permission on a directory gives the right to add or delete files/directories in that directory. That is filesystem specific: in some filesystems you need write/modify permission also (or even just) in the file/directory itself. In some filesystems (AFS, DFS) the permission to add/delete directory entries is a completely separate permission.

ディレクトリへの書き込み/修正権限があれば、そのディレクトリにある ファイル/ディレクトリを追加または削除できると仮定しないでください。 これはファイルシステム依存です: そのファイル/ディレクトリ自身の 書き込み/修正権限も(あるいはそれだけが)必要なファイルシステムもあります。 一部のファイルシステム (AFS, DFS) では、ディレクトリ要素の追加/削除権限は 完全に別の権限です。

Don't assume that a single unlink completely gets rid of the file: some filesystems (most notably the ones in VMS) have versioned filesystems, and unlink() removes only the most recent one (it doesn't remove all the versions because by default the native tools on those platforms remove just the most recent version, too). The portable idiom to remove all the versions of a file is

1 回の unlink で完全にファイルを取り除けると仮定しないでください: 一部のファイルシステム (もっとも顕著なものは VMS) はバージョン管理された ファイルシステムを持ち、unlink() は単に最新のものだけを削除します (デフォルトではネイティブなツールも単に最新のバージョンを削除するので、 全てのバージョンは削除しません)。 あるファイルの全てのバージョンを削除するための移植性のある慣用句は:

    1 while unlink "file";

This will terminate if the file is undeleteable for some reason (protected, not there, and so on).

これは (保護されている、存在しない、など) 何らかの理由でファイルが 削除できないときに終了します。

Don't count on a specific environment variable existing in %ENV. Don't count on %ENV entries being case-sensitive, or even case-preserving. Don't try to clear %ENV by saying %ENV = ();, or, if you really have to, make it conditional on $^O ne 'VMS' since in VMS the %ENV table is much more than a per-process key-value string table.

特定の環境変数が %ENV にあるということを計算に入れないでください。 %ENV のエントリが大文字小文字を認識するかや、大文字小文字が 保存されるかすらも計算に入れないでください。 %ENV をクリアするために %ENV = (); としないでください; もし 本当にそうする必要があるなら、$^O ne 'VMS' という条件付きで 行ってください; VMS では %ENV テーブルはプロセス単位のキー/値文字列 テーブル以上のものだからです。

On VMS, some entries in the %ENV hash are dynamically created when their key is used on a read if they did not previously exist. The values for $ENV{HOME}, $ENV{TERM}, $ENV{PATH}, and $ENV{USER}, are known to be dynamically generated. The specific names that are dynamically generated may vary with the version of the C library on VMS, and more may exist than are documented.

VMS では、%ENV ハッシュの一部のエントリは、キーがまだ存在していなければ、 読み込みに使われたときに動的に作成されます。 $ENV{HOME}, $ENV{TERM}, $ENV{PATH}, and $ENV{USER} の値は 動的に作成されると知られています。 動的に作成される具体的な名前は VMS の C ライブラリのバージョンによって 異なり、文書化されているものよりもたくさんあるかもしれません。

On VMS by default, changes to the %ENV hash persist after perl exits. Subsequent invocations of perl in the same process can inadvertently inherit environment settings that were meant to be temporary.

VMS のデフォルトでは、%ENV ハッシュへの変更は、perl が終了した後に 永続化します。 同じプロセスで引き続いて perl を起動すると、一時的のつもりの環境設定が 不注意で継承されることがあります。

Don't count on signals or %SIG for anything.

シグナルや %SIG について何も当てにしないで下さい。

Don't count on filename globbing. Use opendir, readdir, and closedir instead.

ファイル名のグロブを当てにしないで下さい。 代わりに opendir, readdir, closedir を使ってください。

Don't count on per-program environment variables, or per-program current directories.

プログラム単位の環境変数や、プログラム単位のカレントディレクトリを 当てにしないで下さい。

Don't count on specific values of $!, neither numeric nor especially the string values. Users may switch their locales causing error messages to be translated into their languages. If you can trust a POSIXish environment, you can portably use the symbols defined by the Errno module, like ENOENT. And don't trust on the values of $! at all except immediately after a failed system call.

$! の特定の値を計算に入れないでください; 数値でも、特に文字列値でもです。 ユーザーは自分の言語へ翻訳するためにエラーメッセージを引き起こす ロケールを変更するかもしれません。 もし POSIX 的な環境を信用できるなら、ENOENT のような、Errno モジュールで 定義されているシンボルを移植性を持って使えます。 そして、システムコールが失敗した直後以外では $! の値は全く 信用しないでください。

コマンド名かファイルパス名か

Don't assume that the name used to invoke a command or program with system or exec can also be used to test for the existence of the file that holds the executable code for that command or program. First, many systems have "internal" commands that are built-in to the shell or OS and while these commands can be invoked, there is no corresponding file. Second, some operating systems (e.g., Cygwin, DJGPP, OS/2, and VOS) have required suffixes for executable files; these suffixes are generally permitted on the command name but are not required. Thus, a command like "perl" might exist in a file named "perl", "perl.exe", or "perl.pm", depending on the operating system. The variable "_exe" in the Config module holds the executable suffix, if any. Third, the VMS port carefully sets up $^X and $Config{perlpath} so that no further processing is required. This is just as well, because the matching regular expression used below would then have to deal with a possible trailing version number in the VMS file name.

systemexec でコマンドやプログラムを起動するために使われた名前が、 そのコマンドやプログラムの実行可能コードを保持しているファイルの存在の テストにも使えると仮定しないでください。 1 番目に、多くのシステムはシェルや OS に組み込まれている「内部」コマンドを 持ち、これらのコマンドは起動できますが、対応するファイルはありません。 2 番目に、一部のオペレーティングシステム(例えば Cygwin, DJGPP, OS/2, VOS) は 実行ファイルに拡張子が必要です; これらの拡張子は一般的にコマンド名として ゆるされていますが要求されてはいません。 従って、"perl" のようなコマンドは OS に依存して、"perl", "perl.exe", "perl.pm" のようなファイルとして存在しているかもしれません。 Config モジュールの変数 "_exe" は、(もしあれば)実行形式の拡張子を 保持します。 3 番目に、VMS 版はそれ以上の処理が不要なように慎重に $^X$Config{perlpath} を設定します。 これは、以下に示す正規表現のマッチングがそれから VMS ファイル名に あるかもしれない末尾のバージョン番号を扱う必要があるからです。

To convert $^X to a file pathname, taking account of the requirements of the various operating system possibilities, say:

$^X をファイルパス名に変換するとき、以下のように、様々な オペレーティングシステムの可能性の要求を考慮してください:

 use Config;
 my $thisperl = $^X;
 if ($^O ne 'VMS')
    {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;}

To convert $Config{perlpath} to a file pathname, say:

$Config{perlpath} をファイルのパス名に変換するには、例えば:

 use Config;
 my $thisperl = $Config{perlpath};
 if ($^O ne 'VMS')
    {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;}

ネットワーク

Don't assume that you can reach the public Internet.

公共のインターネットに届くことを仮定しないでください。

Don't assume that there is only one way to get through firewalls to the public Internet.

ファイアウォールを通って公共のインターネットへ出る道が 一つだけあるということを仮定しないでください。

Don't assume that you can reach outside world through any other port than 80, or some web proxy. ftp is blocked by many firewalls.

ポート 80 やいくつかのウェブプロキシ以外で、外側の世界に届くことを 仮定しないでください。 ftp は多くのファイアウォールでブロックされます。

Don't assume that you can send email by connecting to the local SMTP port.

ローカル SMTP ポートに接続することで e メールを送信できると 仮定しないでください。

Don't assume that you can reach yourself or any node by the name 'localhost'. The same goes for '127.0.0.1'. You will have to try both.

'localhost' という名前で自分自身やその他のノードに届くと 仮定しないでください。 同じことは '127.0.0.1' にも言えます。 両方を試す必要があります。

Don't assume that the host has only one network card, or that it can't bind to many virtual IP addresses.

ホストに 1 枚だけネットワークカードがあるとか、複数の仮想 IP アドレスを 割り当てられないと仮定しないでください。

Don't assume a particular network device name.

特定のネットワークデバイス名を仮定しないでください。

Don't assume a particular set of ioctl()s will work.

特定の ioctl() が動作することを仮定しないでください。

Don't assume that you can ping hosts and get replies.

ホストに ping して結果が受け取れると仮定しないでください。

Don't assume that any particular port (service) will respond.

特定のポート (サービス) が返答すると仮定しないでください。

Don't assume that Sys::Hostname (or any other API or command) returns either a fully qualified hostname or a non-qualified hostname: it all depends on how the system had been configured. Also remember that for things such as DHCP and NAT, the hostname you get back might not be very useful.

Sys::Hostname (またはその他の API やコマンド) が完全修飾ホスト名か 修飾されないホスト名のどちらかを返すと仮定しないでください: これら全ては システムがどのように設定されているかに依存します。 また、DHCP や NAT のようなものでは、受け取るホスト名は全く 有用ではないかもしれないことも忘れないでください。

All the above "don't":s may look daunting, and they are, but the key is to degrade gracefully if one cannot reach the particular network service one wants. Croaking or hanging do not look very professional.

上述した全ての「べからず」は怯えさせるものかもしれません; そしてその 通りです; しかし鍵は、望んでいる特定のネットワークサービスに 到達できないときに、適切にデグレードすることです。 croak やハングアップではとてもプロの仕事には見えません。

プロセス間通信(IPC)

In general, don't directly access the system in code meant to be portable. That means, no system, exec, fork, pipe, ``, qx//, open with a |, nor any of the other things that makes being a Perl hacker worth being.

一般的に、移植性を持たせるコード内でシステムに直接アクセスしないでください。 つまり、system, exec, fork, pipe, ``, qx//, open での | その他 Perl ハッカーが価値があると思うものです。

Commands that launch external processes are generally supported on most platforms (though many of them do not support any type of forking). The problem with using them arises from what you invoke them on. External tools are often named differently on different platforms, may not be available in the same location, might accept different arguments, can behave differently, and often present their results in a platform-dependent way. Thus, you should seldom depend on them to produce consistent results. (Then again, if you're calling netstat -a, you probably don't expect it to run on both Unix and CP/M.)

外部プロセスを起動するコマンドは一般的にほとんどのプラットフォームで 対応しています(しかしその多くは fork に対応していません)。 これらを使うときの問題は何を起動するかということから発生します。 外部ツールはプラットフォームが異なればしばしば異なった名前となり、 同じ場所で利用可能ではないかもしれず、異なった引数を受け取るかもしれず、 異なった動作をするかもしれず、しばしば結果をプラットフォームに依存した形で 表現します。 従って、一貫した結果を生成するために、ほとんどそのようなものに 依存しないようにするべきです。 (再び、netstat -a を呼び出すなら、おそらく Unix と CP/M の両方で 呼び出すことを想定していないでしょう。)

One especially common bit of Perl code is opening a pipe to sendmail:

特に一般的な Perl コードの一つは sendmail へのパイプを開くことです:

    open(MAIL, '|/usr/lib/sendmail -t')
        or die "cannot fork sendmail: $!";

This is fine for systems programming when sendmail is known to be available. But it is not fine for many non-Unix systems, and even some Unix systems that may not have sendmail installed. If a portable solution is needed, see the various distributions on CPAN that deal with it. Mail::Mailer and Mail::Send in the MailTools distribution are commonly used, and provide several mailing methods, including mail, sendmail, and direct SMTP (via Net::SMTP) if a mail transfer agent is not available. Mail::Sendmail is a standalone module that provides simple, platform-independent mailing.

sendmail が利用可能であることが分かっているならシステム プログラミングとしてうまく動きます。 しかし多くの非 Unix システムや、Unix でも sendmail が インストールされていないシステムではうまく動きません。 移植性のある解法が必要なら、CPAN にあるこれを扱うための様々な ディストリビューションを参照してください。 Mail::Mailer および MailToolsMail::Send は一般的に使われ、mailsendmail、メール転送エージェントが利用できないなら (Net::SMTP 経由で) SMTP 直接を含むいくつかのメール送信メソッドを提供します。 Mail::Sendmail は単純で、プラットフォーム独立なメール送信を提供する 単体のモジュールです。

The Unix System V IPC (msg*(), sem*(), shm*()) is not available even on all Unix platforms.

Unix System V IPC (msg*(), sem*(), shm*()) は Unix プラットフォームでさえも全てで利用できるわけではありません。

Do not use either the bare result of pack("N", 10, 20, 30, 40) or bare v-strings (such as v10.20.30.40) to represent IPv4 addresses: both forms just pack the four bytes into network order. That this would be equal to the C language in_addr struct (which is what the socket code internally uses) is not guaranteed. To be portable use the routines of the Socket extension, such as inet_aton(), inet_ntoa(), and sockaddr_in().

IPv4 アドレスを表現するために pack("N", 10, 20, 30, 40) の生の結果や (v10.20.30.40 のような)生のv-文字列を使わないでください: どちらの 形式も単に 4 バイトをネットワーク順序で pack しています。 これが(ソケットコードが内部で使う) C 言語の in_addr 構造体と 同じであることは保証されていません。 移植性を持たせるためには、inet_aton(), inet_ntoa(), sockaddr_in() のような、Socket エクステンションのルーチンを 使ってください。

The rule of thumb for portable code is: Do it all in portable Perl, or use a module (that may internally implement it with platform-specific code, but exposes a common interface).

移植性のあるコードのための経験的な法則は: 全て移植性のある Perl でするか、 モジュールを使ってください (これは内部でプラットフォーム依存の実装を しているかもしれませんが、一般的なインターフェースを晒しています)。

外部サブルーチン(XS)

XS code can usually be made to work with any platform, but dependent libraries, header files, etc., might not be readily available or portable, or the XS code itself might be platform-specific, just as Perl code might be. If the libraries and headers are portable, then it is normally reasonable to make sure the XS code is portable, too.

XS コードは普通どのプラットフォームでも動作するように作られていますが、 依存ライブラリ、ヘッダファイルなどが利用可能でなかったり移植性がなかったり、 XS コード自身が (Perl コードがそうであるかもしれないように) プラットフォーム依存かもしれません。 ライブラリとヘッダに移植性があるなら、XS コードも移植性があると 考えるのは普通合理的です。

A different type of portability issue arises when writing XS code: availability of a C compiler on the end-user's system. C brings with it its own portability issues, and writing XS code will expose you to some of those. Writing purely in Perl is an easier way to achieve portability.

XS コードを書くときには違った種類の移植性の問題が発生します: エンドユーザーのシステムで C コンパイラが利用できるかです。 C はそれ自身の移植性の問題があり、XS コードはそれらのいくつかを晒します。 ピュア Perl で書くことは移植性を達成するより簡単な方法です。

標準モジュール

In general, the standard modules work across platforms. Notable exceptions are the CPAN module (which currently makes connections to external programs that may not be available), platform-specific modules (like ExtUtils::MM_VMS), and DBM modules.

一般的に、標準モジュールはどのプラットフォームでも動きます。 注目するべき例外は CPAN モジュール (今のところ利用可能でないかもしれない 外部プログラムと接続します)、(ExtUtils::MM_VMS のような) プラットフォーム固有のモジュール、DBM モジュールです。

There is no one DBM module available on all platforms. SDBM_File and the others are generally available on all Unix and DOSish ports, but not in MacPerl, where only NDBM_File and DB_File are available.

全てのプラットフォームで利用可能な DBM モジュールはありません。 SDBM_File とその他は一般的に全ての Unix と DOS 風版で利用可能ですが、 MacPerl では利用できず、NBDM_FileDB_File のみが利用可能です。

The good news is that at least some DBM module should be available, and AnyDBM_File will use whichever module it can find. Of course, then the code needs to be fairly strict, dropping to the greatest common factor (e.g., not exceeding 1K for each record), so that it will work with any DBM module. See AnyDBM_File for more details.

いい知らせは、少なくとも何らかの DBM モジュールは利用可能なはずで、 AnyDBM_File は見付かったどれかのモジュールを使います。 もちろん、任意の DBM モジュールで動作させるために、コードはかなり厳密で、 最大公約数的機能に限定されます(例えば、各レコードは 1K を超えられません)。 さらなる詳細については AnyDBM_File を参照してください。

時刻と日付

The system's notion of time of day and calendar date is controlled in widely different ways. Don't assume the timezone is stored in $ENV{TZ}, and even if it is, don't assume that you can control the timezone through that variable. Don't assume anything about the three-letter timezone abbreviations (for example that MST would be the Mountain Standard Time, it's been known to stand for Moscow Standard Time). If you need to use timezones, express them in some unambiguous format like the exact number of minutes offset from UTC, or the POSIX timezone format.

カレンダー日付と時刻のシステムでの記法は大きく異なった方法で 制御されています。 タイムゾーンが $ENV{TZ} に保管されていると仮定しないでください; また例え保管されていても、この変数でタイムゾーンを制御できると 仮定しないでください。 3 文字タイムゾーン略称について何の仮定もしないで下さい (例えば MST は Mountain Standard Time かもしれませんが、Moscow Standard Time としても 知られています)。 タイムゾーンを使う必要があるなら、UTC からの正確な分数や POSIX タイムゾーン形式のような、曖昧さのない形式で記述してしてください。

Don't assume that the epoch starts at 00:00:00, January 1, 1970, because that is OS- and implementation-specific. It is better to store a date in an unambiguous representation. The ISO 8601 standard defines YYYY-MM-DD as the date format, or YYYY-MM-DDTHH:MM:SS (that's a literal "T" separating the date from the time). Please do use the ISO 8601 instead of making us guess what date 02/03/04 might be. ISO 8601 even sorts nicely as-is. A text representation (like "1987-12-18") can be easily converted into an OS-specific value using a module like Date::Parse. An array of values, such as those returned by localtime, can be converted to an OS-specific representation using Time::Local.

紀元が 1970 年 1 月 1 日 00:00:00 に開始されると仮定しないでください; なぜならこれは OS と実装に依存するからです。 曖昧さのない表現で日付を保管した方が良いです。 ISO 8601 標準は日付の形式として YYYY-MM-DD を、あるいは YYYY-MM-DDTHH:MM:SS (リテラルな "T" は日付と時刻を分けています) を 定義しています。 どうか 02/03/04 という日付の意味を推測させるのではなく、ISO 8601 を 使ってください。 ISO 8601 はそのままうまくソートもできます。 ("1987-12-18" のような) テキスト表現は Date::Parse のようなモジュールを 使って簡単に OS 固有の値に変換できます。 localtime で返されるような値の配列は、Time::Local を使って OS 固有の 表現に変換できます。

When calculating specific times, such as for tests in time or date modules, it may be appropriate to calculate an offset for the epoch.

時刻と日付のモジュールのテストのような、特定の時刻を計算するときには、 紀元からのオフセットを計算するのが適切でしょう。

    require Time::Local;
    my $offset = Time::Local::timegm(0, 0, 0, 1, 0, 70);

The value for $offset in Unix will be 0, but in Mac OS Classic will be some large number. $offset can then be added to a Unix time value to get what should be the proper value on any system.

Unix での $offset の値は 0 ですが、Mac OS Classic では 大きな数になります。 それから、$offset は任意のシステムでの適切な値を得るために Unix time に加えられます。

文字集合と文字エンコーディング

Assume very little about character sets.

文字集合について仮定できることはほとんどありません。

Assume nothing about numerical values (ord, chr) of characters. Do not use explicit code point ranges (like \xHH-\xHH). However, starting in Perl v5.22, regular expression pattern bracketed character class ranges specified like qr/[\N{U+HH}-\N{U+HH}]/ are portable. You can portably use symbolic character classes like [:print:].

文字の数値 (ord, chr) について仮定できることはありません。 (\xHH-\xHH のような) 明示的な符号位置の範囲は使わないでください。 しかし、Perl v5.22 から、qr/[\N{U+HH}-\N{U+HH}]/ のように指定した 正規表現パターン大括弧文字クラス範囲は移植性があります。 移植性のある形で [:print:] のようなシンボリックな文字クラスを使えます。

Do not assume that the alphabetic characters are encoded contiguously (in the numeric sense). There may be gaps. Special coding in Perl, however, guarantees that all subsets of qr/[A-Z]/, qr/[a-z]/, and qr/[0-9]/ behave as expected. tr/// behaves the same for these ranges. In patterns, any ranges specified with end points using the \N{...} notations ensures character set portability, but it is a bug in Perl v5.22, that this isn't true of tr///.

英字が(数値的な意味で)連続してエンコードされると仮定しないでください。 隙間があるかもしれません。 しかし、Perl での特別扱いにより、qr/[A-Z]/, qr/[a-z]/, qr/[0-9]/ という部分集合は想定通り振る舞うことが保証されます。 tr/// はこれらの範囲と同様に振る舞います。 In patterns, any ranges specified with end points using the パターンにおいて、\N{...} 記法を使ったエンドポイントで指定した 範囲は文字集合間で移植性がありますが、Perl 5.22 のバグにより、 これは tr/// には当てはまりません。

Do not assume anything about the ordering of the characters. The lowercase letters may come before or after the uppercase letters; the lowercase and uppercase may be interlaced so that both "a" and "A" come before "b"; the accented and other international characters may be interlaced so that ä comes before "b". Unicode::Collate can be used to sort this all out.

文字の順序について何も仮定しないでください。 小文字は大文字の前かもしれませんし後かもしれません; 小文字と大文字が交互に 来るために、"a" と "A" の両方が "b" の前かもしれません; アクセント文字や その他の国際文字は交互に来るかも知れないので ä は "b" の 前かもしれません。 Unicode::Collate はこれらのソートに使えます。

国際化

If you may assume POSIX (a rather large assumption), you may read more about the POSIX locale system from perllocale. The locale system at least attempts to make things a little bit more portable, or at least more convenient and native-friendly for non-English users. The system affects character sets and encoding, and date and time formatting--amongst other things.

POSIX (比較的大きい仮定) を仮定するなら、perllocale から POSIX ロケールシステムについて多くを読めます。 ロケールシステムは少なくとも物事をもう少し移植性のある形にしようとする、 あるいは少なくとも非英語ユーザにとってより便利で母国語に親しくするものです。 このシステムは文字集合とエンコーディング、日付と時刻の形式 -- 他のものに 混じって -- に影響を与えます。

If you really want to be international, you should consider Unicode. See perluniintro and perlunicode for more information.

もし本当に国際化したいなら、Unicode を考慮するべきです。 さらなる情報については perluniintroperlunicode を 参照してください。

If you want to use non-ASCII bytes (outside the bytes 0x00..0x7f) in the "source code" of your code, to be portable you have to be explicit about what bytes they are. Someone might for example be using your code under a UTF-8 locale, in which case random native bytes might be illegal ("Malformed UTF-8 ...") This means that for example embedding ISO 8859-1 bytes beyond 0x7f into your strings might cause trouble later. If the bytes are native 8-bit bytes, you can use the bytes pragma. If the bytes are in a string (regular expressions being curious strings), you can often also use the \xHH or more portably, the \N{U+HH} notations instead of embedding the bytes as-is. If you want to write your code in UTF-8, you can use utf8.

非 ASCII バイト (0x00..0x7f の範囲外のバイト) を「ソースコード」に 使いたいなら、移植性のために、そのバイトが何であるかを明示的にする必要が あります。 誰かが例えばそのコードを UTF-8 ロケールで使うかもしれず、その場合 ランダムなネイティブのバイトは不正となります ("Malformed UTF-8 ...")。 これは例えば 0x7f を超える ISO 8859-1 のバイトを文字列に組み込むと あとで問題を引き起こすかもしれないということです。 そのバイトがネイティブな 8 ビットバイトなら、bytes プラグマを使えます。 そのバイトが文字列にある(正規表現はおかしな文字列になります)なら、 そのバイトをそのまま組み込む代わりに \xHH や、より移植性のある \N{U+HH} 表記もしばしば使われます。 コードを UTF-8 で書きたいなら、utf8 が使えます。

システムリソース

If your code is destined for systems with severely constrained (or missing!) virtual memory systems then you want to be especially mindful of avoiding wasteful constructs such as:

あなたのコードが仮想メモリについて厳しく制限された(あるいは存在しない!) システムで動作することになっているなら、特に 以下のような無駄な構造を 避けたいです:

    my @lines = <$very_large_file>;            # bad

    while (<$fh>) {$file .= $_}                # sometimes bad
    my $file = join('', <$fh>);                # better

The last two constructs may appear unintuitive to most people. The first repeatedly grows a string, whereas the second allocates a large chunk of memory in one go. On some systems, the second is more efficient than the first.

最後の二つの構造はほとんどの人々にとって直観的ではないかもしれません。 一番目は徐々に文字列が大きくなり、二番目は一度に大きなメモリの塊を 割り当てます。 システムによっては、二番目の方が一番目よりも効率的です。

セキュリティ

Most multi-user platforms provide basic levels of security, usually implemented at the filesystem level. Some, however, unfortunately do not. Thus the notion of user id, or "home" directory, or even the state of being logged-in, may be unrecognizable on many platforms. If you write programs that are security-conscious, it is usually best to know what type of system you will be running under so that you can write code explicitly for that platform (or class of platforms).

ほとんどのマルチユーザプラットフォームでは(普通はファイルシステムで 実装された)基本的なレベルのセキュリティを提供しています。 しかし、一部は残念ながらそうではありません。 従ってユーザー ID、"home" ディレクトリ、あるいはログインしているかどうか という概念すら多くのプラットフォームでは認識できないかもしれません。 セキュリティを意識したプログラムを書くなら、どの種類のシステムで 実行されるかを知るのが普通は最良です; これによって明示的にその プラットフォーム(またはプラットフォームの種類)のためのコードを書けます。

Don't assume the Unix filesystem access semantics: the operating system or the filesystem may be using some ACL systems, which are richer languages than the usual rwx. Even if the rwx exist, their semantics might be different.

Unix のファイルシステムアクセス意味論を仮定しないでください: オペレーティングシステムやファイルシステムは通常の rwx よりも豊富な 機能を持つ ACL システムを使っているかもしれません。 rwx が存在したとしても、意味は違うかもしれません。

(From the security viewpoint, testing for permissions before attempting to do something is silly anyway: if one tries this, there is potential for race conditions. Someone or something might change the permissions between the permissions check and the actual operation. Just try the operation.)

(セキュリティの面からは、何かをしようとする前に権限をテストするのは そもそもばかげています: そうしようとすると、潜在的な競合条件があります。 権限チェックと実際の操作の間に誰かまたは何かが権限を変えるかもしれません。 単に操作を試してください。)

Don't assume the Unix user and group semantics: especially, don't expect $< and $> (or $( and $)) to work for switching identities (or memberships).

Unix のユーザーとグループの意味論を仮定しないでください: 特に、ユーザー (あるいはグループ)を切り替えるのに $<$> (または $($)) が動作すると想定しないでください。

Don't assume set-uid and set-gid semantics. (And even if you do, think twice: set-uid and set-gid are a known can of security worms.)

set-uid と set-gid の動作を仮定しないでください。 (そしてそうしたとしても、二度考えてください: set-uid と set-gid はセキュリティの虫の缶詰として知られています。)

スタイル

For those times when it is necessary to have platform-specific code, consider keeping the platform-specific code in one place, making porting to other platforms easier. Use the Config module and the special variable $^O to differentiate platforms, as described in "PLATFORMS".

プラットフォーム固有のコードを書く必要がある時には、プラットフォーム固有の コードを 1 箇所に集めて、他のプラットフォームへの移植をより容易にすることを 考慮してください。 "PLATFORMS" で記述されているように、プラットフォームを識別するために Config モジュールと特殊変数 $^O を使ってください。

Be careful in the tests you supply with your module or programs. Module code may be fully portable, but its tests might not be. This often happens when tests spawn off other processes or call external programs to aid in the testing, or when (as noted above) the tests assume certain things about the filesystem and paths. Be careful not to depend on a specific output style for errors, such as when checking $! after a failed system call. Using $! for anything else than displaying it as output is doubtful (though see the Errno module for testing reasonably portably for error value). Some platforms expect a certain output format, and Perl on those platforms may have been adjusted accordingly. Most specifically, don't anchor a regex when testing an error value.

モジュールやプログラムと共に提供するテストには注意してください。 モジュールのコードは完全に移植性があるかも知れませんが、 テストはそうではないかもしれません。 これは、テストの助けとするために他のプロセスを起動したり外部のプログラムを 呼び出したりしたり、テストが(上述したように)ファイルシステムやパスについて ある種の仮定をしたときにしばしば起こります。 システムコールに失敗したあとの $! のような、エラーの特定の出力形式に 依存しないように注意してください。 出力として表示する以外のことに $! を使うことは疑問があります(しかし エラー値について十分な移植性のあるテストを刷るための Errno モジュールを 参照してください)。 一部のプラットフォームはある種の出力形式を想定していて、それらの プラットフォームの Perl はそれに応じて調整します。 もっとも厳密に言えば、エラー値をテストするときに正規表現を 使わないでください。

CPAN Testers

Modules uploaded to CPAN are tested by a variety of volunteers on different platforms. These CPAN testers are notified by mail of each new upload, and reply to the list with PASS, FAIL, NA (not applicable to this platform), or UNKNOWN (unknown), along with any relevant notations.

CPAN にアップロードされたモジュールは色々なプラットフォームで 様々なボランティアによってテストされます。 これらの CPAN testers は新しくアップロードされることにメールによって 通知され、PASS, FAIL, NA (このプラットフォームでは不適切), UNKNOWN (不明) のいずれかを、関連する情報と共に返信します。

The purpose of the testing is twofold: one, to help developers fix any problems in their code that crop up because of lack of testing on other platforms; two, to provide users with information about whether a given module works on a given platform.

テストの目的は二つあります: 一つ目は、他のプラットフォームのテストが ないことによって突然現れるコードの問題を開発者が修正することを 助けるためです; 二つ目は、あるモジュールがあるプラットフォームで 動作するかどうかの情報をユーザーに提供することです。

Also see:

以下も参照してください:

プラットフォーム

Perl is built with a $^O variable that indicates the operating system it was built on. This was implemented to help speed up code that would otherwise have to use Config and use the value of $Config{osname}. Of course, to get more detailed information about the system, looking into %Config is certainly recommended.

Perl は $^O 変数がビルドされたオペレーティング システムを示すような形でビルドされます。 これは、use Config して $Config{osname} の値を調べる必要が ないようにすることで高速化を助けています。 もちろんシステムからもっと詳細な情報を得るなら、%Config を 見ることが確実にお勧めです。

%Config cannot always be trusted, however, because it was built at compile time. If perl was built in one place, then transferred elsewhere, some values may be wrong. The values may even have been edited after the fact.

しかし、%Config はコンパイル時にビルドされるので、常に 信頼するというわけにはいきません。 perl がある場所でビルドされ、それから別の場所に移されると、いくつかの 値は間違ったものになるかもしれません。 値は後から修正することすらできます。

Unix

Perl works on a bewildering variety of Unix and Unix-like platforms (see e.g. most of the files in the hints/ directory in the source code kit). On most of these systems, the value of $^O (hence $Config{'osname'}, too) is determined either by lowercasing and stripping punctuation from the first field of the string returned by typing uname -a (or a similar command) at the shell prompt or by testing the file system for the presence of uniquely named files such as a kernel or header file. Here, for example, are a few of the more popular Unix flavors:

Perl は驚くほど色々な Unix と Unix 風プラットフォームで動作します (例えば ソースコードキットの hints/ ディレクトリのほとんどのファイルを 参照してください)。 これらのシステムのほとんどでは、$^O の値は (従って $Config{'osname'} の値も)、シェルプロンプトから uname -a (または 似たようなコマンド) で返された文字列の最初のフィールドから句読点を 取り除いて小文字にしたものか、カーネルやヘッダファイルのようなユニークな 名前の付いたファイルの存在をファイルシステムで調べることによって 決定されます。 例えば、以下はより有名な Unix 風システムのいくつかです:

    uname         $^O        $Config{'archname'}
    --------------------------------------------
    AIX           aix        aix
    BSD/OS        bsdos      i386-bsdos
    Darwin        darwin     darwin
    DYNIX/ptx     dynixptx   i386-dynixptx
    FreeBSD       freebsd    freebsd-i386
    Haiku         haiku      BePC-haiku
    Linux         linux      arm-linux
    Linux         linux      armv5tel-linux
    Linux         linux      i386-linux
    Linux         linux      i586-linux
    Linux         linux      ppc-linux
    HP-UX         hpux       PA-RISC1.1
    IRIX          irix       irix
    Mac OS X      darwin     darwin
    NeXT 3        next       next-fat
    NeXT 4        next       OPENSTEP-Mach
    openbsd       openbsd    i386-openbsd
    OSF1          dec_osf    alpha-dec_osf
    reliantunix-n svr4       RM400-svr4
    SCO_SV        sco_sv     i386-sco_sv
    SINIX-N       svr4       RM400-svr4
    sn4609        unicos     CRAY_C90-unicos
    sn6521        unicosmk   t3e-unicosmk
    sn9617        unicos     CRAY_J90-unicos
    SunOS         solaris    sun4-solaris
    SunOS         solaris    i86pc-solaris
    SunOS4        sunos      sun4-sunos

Because the value of $Config{archname} may depend on the hardware architecture, it can vary more than the value of $^O.

$Config{archname} の値はハードウェアアーキテクチャに依存しているため、 $^O の値よりも様々な値になります。

DOS とその派生

Perl has long been ported to Intel-style microcomputers running under systems like PC-DOS, MS-DOS, OS/2, and most Windows platforms you can bring yourself to mention (except for Windows CE, if you count that). Users familiar with COMMAND.COM or CMD.EXE style shells should be aware that each of these file specifications may have subtle differences:

Perl は昔から Intel 形式のマイクロコンピュータで動作する PC-DOS, MS-DOS, OS/2 のようなシステムと、あなたが指摘できるようなほとんど全ての Windows プラットフォーム(もし Windows CE を含めるなら、これは除きます)に 移植されてきました。 COMMAND.COMCMD.EXE 形式のシェルになれているユーザーは、 以下のようなファイル指定に少しずつ違いがあることに気がつくはずです:

    my $filespec0 = "c:/foo/bar/file.txt";
    my $filespec1 = "c:\\foo\\bar\\file.txt";
    my $filespec2 = 'c:\foo\bar\file.txt';
    my $filespec3 = 'c:\\foo\\bar\\file.txt';

System calls accept either / or \ as the path separator. However, many command-line utilities of DOS vintage treat / as the option prefix, so may get confused by filenames containing /. Aside from calling any external programs, / will work just fine, and probably better, as it is more consistent with popular usage, and avoids the problem of remembering what to backwhack and what not to.

システムコールはパス区切りとして / または \ のどちらかを受け付けます。 しかし、古い DOS のコマンドラインユーティリティは / をオプションの 接頭辞として扱うので、ファイル名に / が含まれていると混乱するかも しれません。 外部プログラムを呼び出すことを除いて、/ はとてもうまく動作し、おそらく よりよいです; なぜなら一般的な使用法でより一貫性があって、何が バックスラッシュで何が層でないかを覚えるという問題を避けられます。

The DOS FAT filesystem can accommodate only "8.3" style filenames. Under the "case-insensitive, but case-preserving" HPFS (OS/2) and NTFS (NT) filesystems you may have to be careful about case returned with functions like readdir or used with functions like open or opendir.

DOS FAT ファイルシステムは "8.3" 形式のファイル名にのみ対応しています。 「大文字小文字を無視するが、保存する」HPFS (OS/2) と NTFS (NT) ファイルシステムでは readdir のような関数から返されたり、openopendir のような関数で使う大文字小文字に注意する必要が あるかもしれません。

DOS also treats several filenames as special, such as AUX, PRN, NUL, CON, COM1, LPT1, LPT2, etc. Unfortunately, sometimes these filenames won't even work if you include an explicit directory prefix. It is best to avoid such filenames, if you want your code to be portable to DOS and its derivatives. It's hard to know what these all are, unfortunately.

DOS はまた、AUX, PRN, NUL, CON, COM1, LPT1, LPT2 のようないくつかの ファイル名を特別に扱います。 残念ながら、ときどきこれらのファイル名は明示的なディレクトリ接頭辞に 含んでいても動作しません。 コードに DOS とその派生で移植性があるようにするには、これらのファイル名を 避けるのが最良です。 残念ながら、これら全てを知るのは難しいです。

Users of these operating systems may also wish to make use of scripts such as pl2bat.bat or pl2cmd to put wrappers around your scripts.

これらのオペレーティングシステムのユーザーは、スクリプトのラッパーとして pl2bat.batpl2cmd のようなスクリプトを使いたいかもしれません。

Newline (\n) is translated as \015\012 by STDIO when reading from and writing to files (see "Newlines"). binmode(FILEHANDLE) will keep \n translated as \012 for that filehandle. Since it is a no-op on other systems, binmode should be used for cross-platform code that deals with binary data. That's assuming you realize in advance that your data is in binary. General-purpose programs should often assume nothing about their data.

ファイルから読み書きするとき、改行 (\n) は STDIO によって \015\012 に 変換されます("Newlines" を参照してください)。 binmode(FILEHANDLE) は、このファイルハンドルに対して \n\012 として変換されます。 これはその他のシステムでは何もしないので、バイナリデータを扱う クロスプラットフォームコードでは binmode を使うべきです。 これは、予めデータがバイナリであることが分かっていることを仮定しています。 汎用プログラムはデータについて何も仮定しないべきです。

The $^O variable and the $Config{archname} values for various DOSish perls are as follows:

様々な DOS 的な perl での $^O 変数と $Config{archname} の値は 以下の通りです:

     OS            $^O      $Config{archname}   ID    Version
     --------------------------------------------------------
     MS-DOS        dos        ?
     PC-DOS        dos        ?
     OS/2          os2        ?
     Windows 3.1   ?          ?                 0      3 01
     Windows 95    MSWin32    MSWin32-x86       1      4 00
     Windows 98    MSWin32    MSWin32-x86       1      4 10
     Windows ME    MSWin32    MSWin32-x86       1      ?
     Windows NT    MSWin32    MSWin32-x86       2      4 xx
     Windows NT    MSWin32    MSWin32-ALPHA     2      4 xx
     Windows NT    MSWin32    MSWin32-ppc       2      4 xx
     Windows 2000  MSWin32    MSWin32-x86       2      5 00
     Windows XP    MSWin32    MSWin32-x86       2      5 01
     Windows 2003  MSWin32    MSWin32-x86       2      5 02
     Windows Vista MSWin32    MSWin32-x86       2      6 00
     Windows 7     MSWin32    MSWin32-x86       2      6 01
     Windows 7     MSWin32    MSWin32-x64       2      6 01
     Windows 2008  MSWin32    MSWin32-x86       2      6 01
     Windows 2008  MSWin32    MSWin32-x64       2      6 01
     Windows CE    MSWin32    ?                 3
     Cygwin        cygwin     cygwin

The various MSWin32 Perl's can distinguish the OS they are running on via the value of the fifth element of the list returned from Win32::GetOSVersion(). For example:

様々な MSWin32 Perl は、Win32::GetOSVersion() から返されるリストの 5 番目の 要素の値を使って動作している OS を区別できます。 例えば:

    if ($^O eq 'MSWin32') {
        my @os_version_info = Win32::GetOSVersion();
        print +('3.1','95','NT')[$os_version_info[4]],"\n";
    }

There are also Win32::IsWinNT() and Win32::IsWin95(); try perldoc Win32, and as of libwin32 0.19 (not part of the core Perl distribution) Win32::GetOSName(). The very portable POSIX::uname() will work too:

また Win32::IsWinNT()Win32::IsWin95() もあります; perldoc Win32 を 試してみてください; そして libwin32 0.19 (コア Perl 配布の一部では ありません) からは Win32::GetOSName() があります。 とても移植性のある POSIX::uname() も動作します:

    c:\> perl -MPOSIX -we "print join '|', uname"
    Windows NT|moonru|5.0|Build 2195 (Service Pack 2)|x86

Also see:

以下も参照してください:

VMS

Perl on VMS is discussed in perlvms in the Perl distribution.

VMS での Perl は Perl 配布の perlvms で議論されています。

The official name of VMS as of this writing is OpenVMS.

これを書いている時点での VMS の正式名称は OpenVMS です。

Interacting with Perl from the Digital Command Language (DCL) shell often requires a different set of quotation marks than Unix shells do. For example:

Perl と Digital Command Language (DCL) シェルとの相互作用はしばしば Unix シェルが行うのと異なるクォートの種類が必要になります。 例えば:

    $ perl -e "print ""Hello, world.\n"""
    Hello, world.

There are several ways to wrap your Perl scripts in DCL .COM files, if you are so inclined. For example:

もしそうしたいなら、DCL .COM ファイルに Perl スクリプトをラップする いくつかの方法があります。 例えば:

    $ write sys$output "Hello from DCL!"
    $ if p1 .eqs. ""
    $ then perl -x 'f$environment("PROCEDURE")
    $ else perl -x - 'p1 'p2 'p3 'p4 'p5 'p6 'p7 'p8
    $ deck/dollars="__END__"
    #!/usr/bin/perl

    print "Hello from Perl!\n";

    __END__
    $ endif

Do take care with $ ASSIGN/nolog/user SYS$COMMAND: SYS$INPUT if your Perl-in-DCL script expects to do things like $read = <STDIN>;.

Perl-in-DCL スクリプトで $read = <STDIN>; のようなことを することを想定しているなら、$ ASSIGN/nolog/user SYS$COMMAND: SYS$INPUT に 注意してください。

The VMS operating system has two filesystems, designated by their on-disk structure (ODS) level: ODS-2 and its successor ODS-5. The initial port of Perl to VMS pre-dates ODS-5, but all current testing and development assumes ODS-5 and its capabilities, including case preservation, extended characters in filespecs, and names up to 8192 bytes long.

VMS オペレーティングシステムには、on-disk structure (ODS) レベルによって 指定された二つのファイルシステムがあります: ODS-2 とその後継の ODS-5 です。 Perl から VMS への初期移植は ODS-5 以前の時代でしたが、 現在の全てのテストと開発は、大文字小文字の保存、filespecs の拡張文字、 8192 バイトまでの名前のような、ODS-5 とその性能を仮定しています。

Perl on VMS can accept either VMS- or Unix-style file specifications as in either of the following:

VMS での Perl は、 VMS 形式と Unix 形式のファイル指定の両方を、 以下のどちらかの形でも受け付けます:

    $ perl -ne "print if /perl_setup/i" SYS$LOGIN:LOGIN.COM
    $ perl -ne "print if /perl_setup/i" /sys$login/login.com

but not a mixture of both as in:

しかし以下のように両方を混ぜることはできません:

    $ perl -ne "print if /perl_setup/i" sys$login:/login.com
    Can't open sys$login:/login.com: file specification syntax error

In general, the easiest path to portability is always to specify filenames in Unix format unless they will need to be processed by native commands or utilities. Because of this latter consideration, the File::Spec module by default returns native format specifications regardless of input format. This default may be reversed so that filenames are always reported in Unix format by specifying the DECC$FILENAME_UNIX_REPORT feature logical in the environment.

一般的に、最も簡単な移植性のあるパスは、ネイティブなコマンドや ユーティリティで処理する必要がない限り、 常に Unix 型式でファイル名を指定することです。 後者を考慮して、 File::Spec モジュールはデフォルトでは入力形式に関わらず ネイティブなフォーマット仕様を返します。 このデフォルトは、環境で DECC$FILENAME_UNIX_REPORT 機能論理を 指定することで、常に Unix 型式でファイル名を報告するように変更できます。

The file type, or extension, is always present in a VMS-format file specification even if it's zero-length. This means that, by default, readdir will return a trailing dot on a file with no extension, so where you would see "a" on Unix you'll see "a." on VMS. However, the trailing dot may be suppressed by enabling the DECC$READDIR_DROPDOTNOTYPE feature in the environment (see the CRTL documentation on feature logical names).

ファイル型(拡張子)は、(例え長さ 0 でも)VMS フォーマットファイル仕様では 常に存在します。 これは、デフォルトでは、readdir は拡張子のないファイルに対して末尾の ピリオドを返し、Unix で "a" に見えるものが VMS では "a." に 見えることを意味します。 しかし、環境で DECC$READDIR_DROPDOTNOTYPE 機能を有効にすることで、 末尾のドットを省略できます (機能論理名については CRTL 文書を参照してください)。

What \n represents depends on the type of file opened. It usually represents \012 but it could also be \015, \012, \015\012, \000, \040, or nothing depending on the file organization and record format. The VMS::Stdio module provides access to the special fopen() requirements of files with unusual attributes on VMS.

\n が表現しているものはファイルを開く種類に依存します。 普通は \012 を表現しますが、ファイルの構成や記録形式に依存して \015, \012, \015\012, \000, \040 あるいは 何もなしかもしれません。 VMS::Stdio モジュールは VMS での普通でない属性付きのファイルの 特殊な fopen() へのアクセスを提供します。

The value of $^O on OpenVMS is "VMS". To determine the architecture that you are running on refer to $Config{'archname'}.

OpenVMS での $^O の値は "VMS" です。 実行しているアーキテクチャを決定するには、$Config{'archname'} を 参照します。

On VMS, perl determines the UTC offset from the SYS$TIMEZONE_DIFFERENTIAL logical name. Although the VMS epoch began at 17-NOV-1858 00:00:00.00, calls to localtime are adjusted to count offsets from 01-JAN-1970 00:00:00.00, just like Unix.

VMS では、perl は UTC オフセットを SYS$TIMEZONE_DIFFERENTIAL 論理名から 決定します。 VMS の紀元は 17-NOV-1858 00:00:00.00 に始まりますが、localtime の呼び出しは Unix と同様 01-JAN-1970 00:00:00.00 からのオフセットに調整されます。

Also see:

以下も参照してください:

VOS

Perl on VOS (also known as OpenVOS) is discussed in README.vos in the Perl distribution (installed as perlvos). Perl on VOS can accept either VOS- or Unix-style file specifications as in either of the following:

VOS (OpenVOS としても知られます) での Perl は Perl 配布の README.vos (perlvos としてインストールされます) で議論されています。 VOS での Perl は、以下のどちらかのようにして、VOS 形式と Unix 形式のどちらのファイル指定も受け付けます:

    $ perl -ne "print if /perl_setup/i" >system>notices
    $ perl -ne "print if /perl_setup/i" /system/notices

or even a mixture of both as in:

あるいは両方を混ぜて:

    $ perl -ne "print if /perl_setup/i" >system/notices

Even though VOS allows the slash character to appear in object names, because the VOS port of Perl interprets it as a pathname delimiting character, VOS files, directories, or links whose names contain a slash character cannot be processed. Such files must be renamed before they can be processed by Perl.

VOS はオブジェクト名としてスラッシュ文字が現れることを許していますが、 VOS 版の Perl インタプリタはこれをパス名を分割する文字として解釈するので、 名前にスラッシュ文字を含む VOS ファイル、ディレクトリ、リンクは 処理できません。 このようなファイルは Perl によって処理される前に リネームされなければなりません。

Older releases of VOS (prior to OpenVOS Release 17.0) limit file names to 32 or fewer characters, prohibit file names from starting with a - character, and prohibit file names from containing any character matching tr/ !#%&'()*;<=>?//.

古いリリースのVOS(OpenVOS リリース 17.0 以前) ではファイル名を 32 文字 以下に制限していたり、ファイル名を - 文字で始められなかったり、 tr/ !#%&'()*;<=>?// にマッチングする文字を含むことができないという 制限があります。

Newer releases of VOS (OpenVOS Release 17.0 or later) support a feature known as extended names. On these releases, file names can contain up to 255 characters, are prohibited from starting with a - character, and the set of prohibited characters is reduced to any character matching tr/#%*<>?//. There are restrictions involving spaces and apostrophes: these characters must not begin or end a name, nor can they immediately precede or follow a period. Additionally, a space must not immediately precede another space or hyphen. Specifically, the following character combinations are prohibited: space-space, space-hyphen, period-space, space-period, period-apostrophe, apostrophe-period, leading or trailing space, and leading or trailing apostrophe. Although an extended file name is limited to 255 characters, a path name is still limited to 256 characters.

より新しい VOS (OpenVOS リリース 17.0 以降) は拡張名として知られる機能に 対応しています。 これらのリリースでは、ファイル名は 255 文字までで、- 文字で始めることは 禁止され、禁止される文字は tr/#%*<>?// でマッチングするものに 減少しました。 スペースとアポストロフィに関する制限があります: これらの文字は名前の 先頭や末尾、ピリオドの直前や直後には使えません。 更に、スペースはその他のスペースやハイフンの前には使えません。 特に、以下のような文字の組み合わせは禁止されます: スペース-スペース、 スペース-ハイフン、ピリオド-スペース、スペース-ピリオド、 ピリオド-アポストロフィ、アポストロフィ-ピリオド、先頭または末尾のスペース、 先頭または末尾のアポストロフィ。 拡張ファイル名は 255 文字に制限されていますが、パス名は 256 文字に 制限されたままです。

The value of $^O on VOS is "vos". To determine the architecture that you are running on without resorting to loading all of %Config you can examine the content of the @INC array like so:

VOS での $^O の値は "vos" です。 %Config を全て読み込むという手段を使わずに実行しているアーキテクチャを 決定するには、以下のようにして @INC 配列の中身を確認します:

    if ($^O =~ /vos/) {
        print "I'm on a Stratus box!\n";
    } else {
        print "I'm not on a Stratus box!\n";
        die;
    }

Also see:

以下も参照してください:

  • README.vos (installed as perlvos)

    README.vos (perlvos としてインストールされます)

  • The VOS mailing list.

    VOS メーリングリスト。

    There is no specific mailing list for Perl on VOS. You can contact the Stratus Technologies Customer Assistance Center (CAC) for your region, or you can use the contact information located in the distribution files on the Stratus Anonymous FTP site.

    VOS での Perl 専用のメーリングリストはありません。 あなたの地域の Stratus Technologies Customer Assistance Center (CAC) に 連絡を取るか、Stratus Anonymous FTP サイトの配布ファイルにある連絡情報を 使ってください。

  • Stratus Technologies on the web at http://www.stratus.com

    http://ftp.stratus.com/pub/vos/posix/posix.html にある Stratus Technologies の web サイト

  • VOS Open-Source Software on the web at http://ftp.stratus.com/pub/vos/vos.html

    http://ftp.stratus.com/pub/vos/vos.html にある VOS Open-Source Software の web サイト

EBCDIC プラットフォーム

v5.22 core Perl runs on z/OS (formerly OS/390). Theoretically it could run on the successors of OS/400 on AS/400 minicomputers as well as VM/ESA, and BS2000 for S/390 Mainframes. Such computers use EBCDIC character sets internally (usually Character Code Set ID 0037 for OS/400 and either 1047 or POSIX-BC for S/390 systems).

v5.22 コア Perl は z/OS (以前は OS/390) で実行されます。 理論的には、AS/400 ミニコンピュータでの OS/400 の後継、 S/390 メインフレームでの VM/ESA, BS2000 のようなプラットフォームに 移植されています。 このようなコンピュータは内部で EBCDIC 文字集合 (通常は OS/400 では Character Code Set ID 0037、S/390 では 1047 または POSIX-BC の どちらか) を内部で使います。

The rest of this section may need updating, but we don't know what it should say. Please email comments to perlbug@perl.org.

この章の残りの部分は更新する必要がありますが、私たちはどうすれば良いか 分かっていません。 perlbug@perl.org に電子メールでコメントを送ってください。

On the mainframe Perl currently works under the "Unix system services for OS/390" (formerly known as OpenEdition), VM/ESA OpenEdition, or the BS200 POSIX-BC system (BS2000 is supported in Perl 5.6 and greater). See perlos390 for details. Note that for OS/400 there is also a port of Perl 5.8.1/5.10.0 or later to the PASE which is ASCII-based (as opposed to ILE which is EBCDIC-based), see perlos400.

メインフレーム Perl は現在のところ "Unix system services for OS/390" (以前は OpenEdition として知られていたもの), VM/ESA OpenEdition, BS200 POSIX-BC システムで動作します (BS2000 は Perl 5.6 以降で対応します)。 詳しくは perlos390 を参照してください。 OS/400 には (EBCDIC ベースの ILE ではなく) ASCII ベースの PASE への Perl 5.8.1/5.10.0 以降の移植もあることに注意してください; perlos400 を 参照してください。

As of R2.5 of USS for OS/390 and Version 2.3 of VM/ESA these Unix sub-systems do not support the #! shebang trick for script invocation. Hence, on OS/390 and VM/ESA Perl scripts can be executed with a header similar to the following simple script:

OS/390 の USS の R2.5 および VM/ESA のバージョン 2.3 以降、 これらの Unix 副システムはスクリプトの起動のための #! トリックに 対応しなくなりました。 従って、OS/390 と VM/ESA では Perl スクリプトは以下のような単純な スクリプトと似たヘッダ付きで実行できます:

    : # use perl
        eval 'exec /usr/local/bin/perl -S $0 ${1+"$@"}'
            if 0;
    #!/usr/local/bin/perl     # just a comment really

    print "Hello from perl!\n";

OS/390 will support the #! shebang trick in release 2.8 and beyond. Calls to system and backticks can use POSIX shell syntax on all S/390 systems.

OS/390 はリリース 2.8 以降、#! トリックに対応しています。 system と逆クォートの呼び出しは全ての S/390 システムで POSIX シェル文法を 使います。

On the AS/400, if PERL5 is in your library list, you may need to wrap your Perl scripts in a CL procedure to invoke them like so:

AS/400 では、ライブラリリストに PERL5 があれば、以下のようにして CL 手続きで Perl スクリプトをラップする必要があります:

    BEGIN
      CALL PGM(PERL5/PERL) PARM('/QOpenSys/hello.pl')
    ENDPGM

This will invoke the Perl script hello.pl in the root of the QOpenSys file system. On the AS/400 calls to system or backticks must use CL syntax.

これは QOpenSys ファイルシステムのルートにある Perl スクリプト hello.pl を起動します。 AS/400 では system や逆クォートの呼び出しは CL 文法を 使わなければなりません。

On these platforms, bear in mind that the EBCDIC character set may have an effect on what happens with some Perl functions (such as chr, pack, print, printf, ord, sort, sprintf, unpack), as well as bit-fiddling with ASCII constants using operators like ^, & and |, not to mention dealing with socket interfaces to ASCII computers (see "Newlines").

これらのプラットフォームでは、(chr, pack, print, printf, ord, sort, sprintf, unpack のような) 一部の Perl の関数および、^, &, | のような演算子を使った ASCII 定数のビット操作での効果が EBCDIC 文字では異なることがあることに 注意してください; ASCII コンピュータへのソケットインターフェースを 扱うことを言及しません ("Newlines" 参照)。

Fortunately, most web servers for the mainframe will correctly translate the \n in the following statement to its ASCII equivalent (\r is the same under both Unix and z/OS):

幸いにも、メインフレームのほとんどの web サーバは以下の文の \n を ASCII の等価物に正しく変換します (\r は Unix と z/OS で同じです):

    print "Content-type: text/html\r\n\r\n";

The values of $^O on some of these platforms includes:

これらのプラットフォームの $^O の値は以下のようなものです:

    uname         $^O        $Config{'archname'}
    --------------------------------------------
    OS/390        os390      os390
    OS400         os400      os400
    POSIX-BC      posix-bc   BS2000-posix-bc

Some simple tricks for determining if you are running on an EBCDIC platform could include any of the following (perhaps all):

EBCDIC プラットフォームで実行されているかどうかを決定するための 単純なトリックとしては、以下のどれか(おそらく全て)があります:

    if ("\t" eq "\005")   { print "EBCDIC may be spoken here!\n"; }

    if (ord('A') == 193) { print "EBCDIC may be spoken here!\n"; }

    if (chr(169) eq 'z') { print "EBCDIC may be spoken here!\n"; }

One thing you may not want to rely on is the EBCDIC encoding of punctuation characters since these may differ from code page to code page (and once your module or script is rumoured to work with EBCDIC, folks will want it to work with all EBCDIC character sets).

依存したいと思わないだろうことの一つは、句読点文字の EBCDIC エンコードでしょう; これらはコードページによって異なるからです (そして一旦あなたのモジュールやスクリプトが EBCDIC で動作すると噂されると、 人々は全ての EBCDIC 文字集合で動作することを求めます)。

Also see:

以下も参照してください:

  • perlos390, perlos400, perlbs2000, perlebcdic.

  • The perl-mvs@perl.org list is for discussion of porting issues as well as general usage issues for all EBCDIC Perls. Send a message body of "subscribe perl-mvs" to majordomo@perl.org.

    perl-mvs@perl.org メーリングリストは移植の問題および全ての EBCDIC Perl に 関する一般的な使用法について議論するための物です。 メッセージ本体に "subscribe perl-mvs" と書いて majordomo@perl.org に 送ってください。

  • AS/400 Perl information at http://as400.rochester.ibm.com/ as well as on CPAN in the ports/ directory.

    http://as400.rochester.ibm.com/ の AS/400 Perl 情報および CPAN の ports/ ディレクトリ。

Acorn RISC OS

Because Acorns use ASCII with newlines (\n) in text files as \012 like Unix, and because Unix filename emulation is turned on by default, most simple scripts will probably work "out of the box". The native filesystem is modular, and individual filesystems are free to be case-sensitive or insensitive, and are usually case-preserving. Some native filesystems have name length limits, which file and directory names are silently truncated to fit. Scripts should be aware that the standard filesystem currently has a name length limit of 10 characters, with up to 77 items in a directory, but other filesystems may not impose such limitations.

Acorns は Unix と同様 ASCII を使い、テキストファイルの改行 (\n) に \012 を使うのと、Unix ファイル名エミュレーションがデフォルトで 有効なので、ほとんどの単純なスクリプトはおそらく「そのまま」で動作します。 ネイティブなファイルシステムはモジュラー形式で、個々のファイルシステムは 大文字小文字を区別するかしないかは関係なく、普通は大文字小文字を保存します。 ネイティブなファイルシステムの一部は名前の長さに制限があり、 ファイル名とディレクトリ名は収まるように暗黙に切り詰められます。 スクリプトは、標準ファイルシステムは名前の長さが 10 に制限され、一つの ディレクトリに77 アイテムまでに制限されることに注意するべきです; しかし他のファイルシステムはこのような制限はないかもしれません。

Native filenames are of the form

ネイティブなファイル名は以下の形式です:

    Filesystem#Special_Field::DiskName.$.Directory.Directory.File

where

それぞれは以下の通りです:

    Special_Field is not usually present, but may contain . and $ .
    Filesystem =~ m|[A-Za-z0-9_]|
    DsicName   =~ m|[A-Za-z0-9_/]|
    $ represents the root directory
    . is the path separator
    @ is the current directory (per filesystem but machine global)
    ^ is the parent directory
    Directory and File =~ m|[^\0- "\.\$\%\&:\@\\^\|\177]+|

The default filename translation is roughly tr|/.|./|;

デフォルトファイル名変換はだいたい tr|/.|./|; です。

Note that "ADFS::HardDisk.$.File" ne 'ADFS::HardDisk.$.File' and that the second stage of $ interpolation in regular expressions will fall foul of the $. if scripts are not careful.

"ADFS::HardDisk.$.File" ne 'ADFS::HardDisk.$.File' と、正規表現中の $ 展開の第 2 ステージは、スクリプトが注意深くなければ $. を 落とすことに注意してください。

Logical paths specified by system variables containing comma-separated search lists are also allowed; hence System:Modules is a valid filename, and the filesystem will prefix Modules with each section of System$Path until a name is made that points to an object on disk. Writing to a new file System:Modules would be allowed only if System$Path contains a single item list. The filesystem will also expand system variables in filenames if enclosed in angle brackets, so <System$Dir>.Modules would look for the file $ENV{'System$Dir'} . 'Modules'. The obvious implication of this is that fully qualified filenames can start with <> and should be protected when open is used for input.

カンマ区切りの検索リストを含むシステム変数で指定された論理パスも使えます; 従って System:Modules は妥当なファイル名で、 ファイルシステムは、名前がディスク上のオブジェクトを指すようになるまで System$Path のそれぞれの部分に Modules を前置します。 System$Path に単一のアイテムリストが含まれている場合にのみ、 新しいファイル System:Modules に書き込めます。 ファイルシステムはファイル名にシステム変数が角かっこで囲まれていると 展開するので、 <System$Dir>.Modules$ENV{'System$Dir'} . 'Modules' というファイルを探します。 ここから明らかに推測されることは、 完全修飾ファイル名は <> で始まることがありopen が 入力で使われるときは保護されるべきということです。

Because . was in use as a directory separator and filenames could not be assumed to be unique after 10 characters, Acorn implemented the C compiler to strip the trailing .c .h .s and .o suffix from filenames specified in source code and store the respective files in subdirectories named after the suffix. Hence files are translated:

. がディレクトリセパレータとして使われていて、ファイル名の 10 文字目 以降はユニークであると仮定できないので、Acorn はソースコード中に指定された ファイル名から末尾の .c .h .s, .o 拡張子を切り落として、 拡張子の名前のサブディレクトリにそれぞれのファイルを保管するような形で C コンパイラを実装しました。 従ってファイルは変換されます:

    foo.h           h.foo
    C:foo.h         C:h.foo        (logical path variable)
    sys/os.h        sys.h.os       (C compiler groks Unix-speak)
    10charname.c    c.10charname
    10charname.o    o.10charname
    11charname_.c   c.11charname   (assuming filesystem truncates at 10)

The Unix emulation library's translation of filenames to native assumes that this sort of translation is required, and it allows a user-defined list of known suffixes that it will transpose in this fashion. This may seem transparent, but consider that with these rules foo/bar/baz.h and foo/bar/h/baz both map to foo.bar.h.baz, and that readdir and glob cannot and do not attempt to emulate the reverse mapping. Other .'s in filenames are translated to /.

Unix エミュレーションライブラリのファイル名のネイティブへの変換は この種の変換が必要であることを仮定していて、この方法で入れ替える既知の 拡張子のリストをユーザー定義できるようになっています。 これは透過的に思えますが、これらの規則では foo/bar/baz.hfoo/bar/h/baz の両方が foo.bar.h.baz にマッピングされ、readdirglob は逆マッピングのエミュレートを試みることができないことを 考慮してください。 ファイル名中のその他の ./ に変換されます。

As implied above, the environment accessed through %ENV is global, and the convention is that program specific environment variables are of the form Program$Name. Each filesystem maintains a current directory, and the current filesystem's current directory is the global current directory. Consequently, sociable programs don't change the current directory but rely on full pathnames, and programs (and Makefiles) cannot assume that they can spawn a child process which can change the current directory without affecting its parent (and everyone else for that matter).

すでに暗示したように、%ENV を通してアクセスする環境はグローバルで、 プログラム固有環境変数は Program$Name の形に変換されます。 それぞれのファイルシステムはカレントディレクトリを管理し、現在の ファイルシステムのカレントディレクトリは グローバルな カレントディレクトリです。 従って、社交的なプログラムはカレントディレクトリを変更せずに フルパス名に頼り、プログラム(および Makefile) は親 (およびこの意味では その他あらゆるもの)に影響を与えずにカレントディレクトリを変更できる 子プロセスを作成できると仮定できません。

Because native operating system filehandles are global and are currently allocated down from 255, with 0 being a reserved value, the Unix emulation library emulates Unix filehandles. Consequently, you can't rely on passing STDIN, STDOUT, or STDERR to your children.

ネイティブオペレーティングシステムファイルハンドルはグローバルで 現在のところ 255 から下向きに割り当てられ、0 は予約された値なので、 Unix エミュレーションライブラリは Unix ファイルハンドルをエミュレートします。 従って、STDIN, STDOUT, STDERR を子プロセスに渡すことに 頼れません。

The desire of users to express filenames of the form <Foo$Dir>.Bar on the command line unquoted causes problems, too: `` command output capture has to perform a guessing game. It assumes that a string <[^<>]+\$[^<>]> is a reference to an environment variable, whereas anything else involving < or > is redirection, and generally manages to be 99% right. Of course, the problem remains that scripts cannot rely on any Unix tools being available, or that any tools found have Unix-like command line arguments.

コマンドラインでクォートなしに <Foo$Dir>.Bar 形式のファイル名を 記述するというユーザーの欲求も問題を引き起こします: `` コマンド出力 捕捉は推論ゲームをする必要があります。 <[^<>]+\$[^<>]> は環境変数の参照、それ以外の <> が 関係する全てはリダイレクトと推測し、これは一般的に何とか 99% は正しいです。 もちろん、スクリプトはどの Unix ツールが利用可能であることや、見つけた ツールが Unix 風のコマンドライン引数を取ることには頼れないという問題は 残っています。

Extensions and XS are, in theory, buildable by anyone using free tools. In practice, many don't, as users of the Acorn platform are used to binary distributions. MakeMaker does run, but no available make currently copes with MakeMaker's makefiles; even if and when this should be fixed, the lack of a Unix-like shell will cause problems with makefile rules, especially lines of the form cd sdbm && make all, and anything using quoting.

エクステンションと XS は、理論的には、自由なツールを使って誰でも ビルドできます。 実際には、多くの人はできません; Acorn プラットフォームのユーザーは バイナリ配布を使っているからです。 MakeMaker は実行できますが、現在のところ MakeMaker の makefile を処理できる make はありません; たとえこれが修正されても、Unix 風シェルがないので makefile 規則で問題が起こります; 特に cd sdbm && make all 形式の行や、 クォートを使ったものです。

"RISC OS" is the proper name for the operating system, but the value in $^O is "riscos" (because we don't like shouting).

"RISC OS" はオペレーティングシステムの適切な名前ですが、$^O の値は "riscos" (大文字は好まないからです)。

その他の perl

Perl has been ported to many platforms that do not fit into any of the categories listed above. Some, such as AmigaOS, QNX, Plan 9, and VOS, have been well-integrated into the standard Perl source code kit. You may need to see the ports/ directory on CPAN for information, and possibly binaries, for the likes of: aos, Atari ST, lynxos, riscos, Novell Netware, Tandem Guardian, etc. (Yes, we know that some of these OSes may fall under the Unix category, but we are not a standards body.)

Perl は上述したカテゴリ一覧のどれにも当てはまらないような多くの プラットフォームに移植されています。 AmigaOS, QNX, Plan 9, VOS のような一部のものは標準 Perl ソースコードキットと よく統合されています。 Atari ST, lynxos, riscos, Novell Netware, Tandem Guardian など の ようなものについての情報とおそらくバイナリを得るために CPAN の ports/ ディレクトリを見る必要があるかもしれません: (はい、これらの OS の一部は Unix カテゴリに入ることを知っていますが、 私たちは標準の組織ではありません。)

Some approximate operating system names and their $^O values in the "OTHER" category include:

"OTHER" カテゴリにあるいくつかの近似オペレーティングシステム名と その $^O の値は以下のようなものです:

    OS            $^O        $Config{'archname'}
    ------------------------------------------
    Amiga DOS     amigaos    m68k-amigos

See also:

以下も参照してください:

  • Amiga, README.amiga (installed as perlamiga).

    Amiga, README.amiga (perlamiga としてインストールされます)

  • A free perl5-based PERL.NLM for Novell Netware is available in precompiled binary and source code form from http://www.novell.com/ as well as from CPAN.

    Novell Netware 用のフリーの perl5 ベースの PERL.NLM は、コンパイル済みの バイナリとソースコード形式が http://www.novell.com/ および CPAN から 利用可能です。

  • Plan 9, README.plan9

関数実装

Listed below are functions that are either completely unimplemented or else have been implemented differently on various platforms. Following each description will be, in parentheses, a list of platforms that the description applies to.

以下の一覧は、プラットフォームによって全く実装されていないか、 さもなければ異なった形で実装されている関数です。 それぞれの記述にあるかっこは、記述が適用されるプラットフォームの一覧です。

The list may well be incomplete, or even wrong in some places. When in doubt, consult the platform-specific README files in the Perl source distribution, and any other documentation resources accompanying a given port.

一覧は不完全であったり、一部で間違っている可能性があります。 疑わしいときは、Perl ソース配布のプラットフォーム固有の README ファイルや、 プラットフォームに関連するその他の文書リソースをチェックしてください。

Be aware, moreover, that even among Unix-ish systems there are variations.

さらに、Unix 風システムにもバリエーションがあることに注意してください。

For many functions, you can also query %Config, exported by default from the Config module. For example, to check whether the platform has the lstat call, check $Config{d_lstat}. See Config for a full description of available variables.

多くの関数に関して、Config モジュールからデフォルトでエクスポートされる %Config に問い合わせることもできます。 例えば、プラットフォームに lstat 呼び出しがあるかどうかを調べるには、 $Config{d_lstat} を調べてください。 利用可能な変数の完全な説明については Config を参照してください。

Perl 関数のアルファベット順リスト

-X

-w only inspects the read-only file attribute (FILE_ATTRIBUTE_READONLY), which determines whether the directory can be deleted, not whether it can be written to. Directories always have read and write access unless denied by discretionary access control lists (DACLs). (Win32)

-w は読み込み専用ファイル属性 (FILE_ATTRIBUTE_READONLY) のみを調べます; これはディレクトリに書き込めるかどうかではなくディレクトリが 削除できるかどうかを決定します。 ディレクトリは、随意アクセス制御リスト (DACL) で拒否されない限り、常に 読み書きアクセスできます。 (Win32)

-r, -w, -x, and -o tell whether the file is accessible, which may not reflect UIC-based file protections. (VMS)

-r, -w, -x, -o はファイルがアクセス可能かどうかを返し、 UIC ベースのファイル保護を反映しません。 (VMS)

-s by name on an open file will return the space reserved on disk, rather than the current extent. -s on an open filehandle returns the current size. (RISC OS)

開いているファイルへの名前での -s は、現在のエクステントではなく、 ディスク上に予約されている空間を返します。 開いているファイルハンドルへの -s は現在のサイズを返します。 (RISC OS)

-R, -W, -X, -O are indistinguishable from -r, -w, -x, -o. (Win32, VMS, RISC OS)

-R, -W, -X, -O は、-r, -w, -x, -o と 区別が付きません。 (Win32, VMS, RISC OS)

-g, -k, -l, -u, -A are not particularly meaningful. (Win32, VMS, RISC OS)

-g, -k, -l, -u, -A は特に意味はありません。 (Win32, VMS, RISC OS)

-p is not particularly meaningful. (VMS, RISC OS)

-p は特に意味はありません。 (VMS, RISC OS)

-d is true if passed a device spec without an explicit directory. (VMS)

-d は、明示的なディレクトリなしに device spec を渡されると真になります。 (VMS)

-x (or -X) determine if a file ends in one of the executable suffixes. -S is meaningless. (Win32)

-x (または -X) はファイルが実行可能ファイルの拡張子のどれかで 終わっているかを判定します。 -S は無意味です。 (Win32)

-x (or -X) determine if a file has an executable file type. (RISC OS)

-x (または -X) ファイルが実行可能ファイル型かどうかを 決定します。 (RISC OS)

alarm

Emulated using timers that must be explicitly polled whenever Perl wants to dispatch "safe signals" and therefore cannot interrupt blocking system calls. (Win32)

Perl が「安全なシグナル」を発行したいタイミングで明示的に ポーリングされなければならないタイマーを使ってエミュレートされ、 従ってシステムコールのブロックに割り込めません。 (Win32)

atan2

Due to issues with various CPUs, math libraries, compilers, and standards, results for atan2() may vary depending on any combination of the above. Perl attempts to conform to the Open Group/IEEE standards for the results returned from atan2(), but cannot force the issue if the system Perl is run on does not allow it. (Tru64, HP-UX 10.20)

様々な CPU、数値演算ライブラリ、コンパイラ、標準の問題により、atan2() の 結果は上述の組み合わせに依存して様々に異なります。 Perl は atan2() から返される結果を Open Group/IEEE 標準に 準拠させようとしますが、システムの Perl がそれを許さないところで 動作している場合は問題を強制させることはできません。 (Tru64, HP-UX 10.20)

The current version of the standards for atan2() is available at http://www.opengroup.org/onlinepubs/009695399/functions/atan2.html.

atan2() の現在のバージョンの標準は http://www.opengroup.org/onlinepubs/009695399/functions/atan2.html で 利用可能です。

binmode

Meaningless. (RISC OS)

無意味です。 (RISC OS)

Reopens file and restores pointer; if function fails, underlying filehandle may be closed, or pointer may be in a different position. (VMS)

ファイルの再オープンとポインタの復帰; 関数が失敗すると、基となる ファイルハンドルが閉じられたり、ポインタが異なった位置を示すことが あります。 (VMS)

The value returned by tell may be affected after the call, and the filehandle may be flushed. (Win32)

tell から返された値はこの呼び出しの後に影響を受けることがあり、 ファイルハンドルがフラッシュされることがあります。 (Win32)

chmod

Only good for changing "owner" read-write access, "group", and "other" bits are meaningless. (Win32)

「所有者」読み書きアクセスの変更のみ動作し、「グループ」「その他」のビットは 無意味です。 (Win32)

Only good for changing "owner" and "other" read-write access. (RISC OS)

「所有者」と「その他」の読み書きアクセスの変更のみ動作します。 (RISC OS)

Access permissions are mapped onto VOS access-control list changes. (VOS)

アクセス許可は VOS アクセス制御リスト変更に割り当てられます。 (VOS)

The actual permissions set depend on the value of the CYGWIN in the SYSTEM environment settings. (Cygwin)

実際の許可は SYSTEM 環境設定の CYGWIN の値に依存して設定されます。 (Cygwin)

Setting the exec bit on some locations (generally /sdcard) will return true but not actually set the bit. (Android)

一部の場所 (一般的には /sdcard) への実行ビットの設定は真を返しますが 実際にはビットは設定されません。 (Android)

chown

Not implemented. (Win32, Plan 9, RISC OS)

実装されていません。 (Win32, Plan 9, RISC OS)

Does nothing, but won't fail. (Win32)

何もしませんが失敗もしません。 (Win32)

A little funky, because VOS's notion of ownership is a little funky (VOS).

VOS での所有者の概念は少し変なので、少し変です。 (VOS)

chroot

Not implemented. (Win32, VMS, Plan 9, RISC OS, VOS)

実装されていません。 (Win32, VMS, Plan 9, RISC OS, VOS)

crypt

May not be available if library or source was not provided when building perl. (Win32)

perl のビルド時にライブラリかソースが提供されていないと 利用できないかもしれません。 (Win32)

Not implemented. (Android)

実装されていません。 (Android)

dbmclose

Not implemented. (VMS, Plan 9, VOS)

実装されていません。 (VMS, Plan 9, VOS)

dbmopen

Not implemented. (VMS, Plan 9, VOS)

実装されていません。 (VMS, Plan 9, VOS)

dump

Not useful. (RISC OS)

使い道はありません。 (RISC OS)

Not supported. (Cygwin, Win32)

対応していません。 (Cygwin, Win32)

Invokes VMS debugger. (VMS)

VMS デバッガを起動します。 (VMS)

exec

exec LIST without the use of indirect object syntax (exec PROGRAM LIST) may fall back to trying the shell if the first spawn() fails. (Win32)

間接オブジェクト構文 (exec PROGRAM LIST) を使わない exec LIST は、 最初の spawn() が失敗したときにシェルにフォールバックすることがあります。 (Win32)

Does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX)

一部のプラットフォームでは出力ハンドルを自動的にフラッシュしません。 (SunOS, Solaris, HP-UX)

Not supported. (Symbian OS)

対応していません。 (Symbian OS)

exit

Emulates Unix exit() (which considers exit 1 to indicate an error) by mapping the 1 to SS$_ABORT (44). This behavior may be overridden with the pragma use vmsish 'exit'. As with the CRTL's exit() function, exit 0 is also mapped to an exit status of SS$_NORMAL (1); this mapping cannot be overridden. Any other argument to exit() is used directly as Perl's exit status. On VMS, unless the future POSIX_EXIT mode is enabled, the exit code should always be a valid VMS exit code and not a generic number. When the POSIX_EXIT mode is enabled, a generic number will be encoded in a method compatible with the C library _POSIX_EXIT macro so that it can be decoded by other programs, particularly ones written in C, like the GNV package. (VMS)

1SS$_ABORT (44) にマッピングすることで Unix の (エラーを示すために exit 1 を使う) exit() をエミュレートします。 この振る舞いはプラグマ use vmsish 'exit' で上書きされます。 CRTL の exit() 関数と同様、exit 0SS$_NORMAL の終了ステータス (1) にマッピングされます; このマッピングは上書きできません。 exit() へのその他の引数は直接 Perl の終了ステータスとして使われます。 VMS では、将来の POSIX_EXIT モードが有効でない限り、終了コードは 常に有効な VMS 終了コードであり、一般的な数値ではないべきです。 POSIX_EXIT モードが有効なら、一般的な数値は C ライブラリの _POSIX_EXIT と 互換性のあるメソッドにエンコードされるので、その他のプログラム、特に GNV パッケージのような C で書かれているプログラムでデコードできます。 (VMS)

exit() resets file pointers, which is a problem when called from a child process (created by fork()) in BEGIN. A workaround is to use POSIX::_exit. (Solaris)

exit() はファイルポインタをリセットするので、BEGIN 内で (fork() によって作られた) 子プロセスから呼び出されたときに 問題になります。 回避方法は POSIX::_exit を使うことです。 (Solaris)

    exit unless $Config{archname} =~ /\bsolaris\b/;
    require POSIX and POSIX::_exit(0);
fcntl

Not implemented. (Win32)

実装されていません。 (Win32)

Some functions available based on the version of VMS. (VMS)

一部の関数は VMS 版を基として利用可能です。 (VMS)

flock

Not implemented (VMS, RISC OS, VOS).

実装されていません。 (VMS, RISC OS, VOS)

fork

Not implemented. (AmigaOS, RISC OS, VMS)

実装されていません。 (AmigaOS, RISC OS, VMS)

Emulated using multiple interpreters. See perlfork. (Win32)

複数のインタプリタを使ってエミュレートされています。 perlfork を参照してください。 (Win32)

Does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX)

一部のプラットフォームでは出力ハンドルを自動的にフラッシュしません。 (SunOS, Solaris, HP-UX)

getlogin

Not implemented. (RISC OS)

実装されていません。 (RISC OS)

getpgrp

Not implemented. (Win32, VMS, RISC OS)

実装されていません。 (Win32, VMS, RISC OS)

getppid

Not implemented. (Win32, RISC OS)

実装されていません。 (Win32, RISC OS)

getpriority

Not implemented. (Win32, VMS, RISC OS, VOS)

実装されていません。 (Win32, VMS, RISC OS, VOS)

getpwnam

Not implemented. (Win32)

実装されていません。 (Win32)

Not useful. (RISC OS)

使い道はありません。 (RISC OS)

getgrnam

Not implemented. (Win32, VMS, RISC OS)

実装されていません。 (Win32, VMS, RISC OS)

getnetbyname

Not implemented. (Android, Win32, Plan 9)

実装されていません。 (Android, Win32, Plan 9)

getpwuid

Not implemented. (Win32)

実装されていません。 (Win32)

Not useful. (RISC OS)

使い道はありません。 (RISC OS)

getgrgid

Not implemented. (Win32, VMS, RISC OS)

実装されていません。 (Win32, VMS, RISC OS)

getnetbyaddr

Not implemented. (Android, Win32, Plan 9)

実装されていません。 (Android, Win32, Plan 9)

getprotobynumber

Not implemented. (Android)

実装されていません。 (Android)

getservbyport
getpwent

Not implemented. (Android, Win32)

実装されていません。 (Android, Win32)

getgrent

Not implemented. (Android, Win32, VMS)

実装されていません。 (Android, Win32, VMS)

gethostbyname

gethostbyname('localhost') does not work everywhere: you may have to use gethostbyname('127.0.0.1'). (Irix 5)

gethostbyname('localhost') はどこでも動作するわけではありません: gethostbyname('127.0.0.1') を使う必要があるかもしれません。 (Irix 5)

gethostent

Not implemented. (Win32)

実装されていません。 (Win32)

getnetent

Not implemented. (Android, Win32, Plan 9)

実装されていません。 (Android, Win32, Plan 9)

getprotoent

Not implemented. (Android, Win32, Plan 9)

実装されていません。 (Android, Win32, Plan 9)

getservent

Not implemented. (Win32, Plan 9)

実装されていません。 (Win32, Plan 9)

seekdir

Not implemented. (Android)

実装されていません。 (Android)

sethostent

Not implemented. (Android, Win32, Plan 9, RISC OS)

実装されていません。 (Android, Win32, Plan 9, RISC OS)

setnetent

Not implemented. (Win32, Plan 9, RISC OS)

実装されていません。 (Win32, Plan 9, RISC OS)

setprotoent

Not implemented. (Android, Win32, Plan 9, RISC OS)

実装されていません。 (Android, Win32, Plan 9, RISC OS)

setservent

Not implemented. (Plan 9, Win32, RISC OS)

実装されていません。 (Plan 9, Win32, RISC OS)

endpwent

Not implemented. (Win32)

実装されていません。 (Win32)

Either not implemented or a no-op. (Android)

実装されていないか何もしないかです。 (Android)

endgrent

Not implemented. (Android, RISC OS, VMS, Win32)

実装されていません。 (Android, RISC OS, VMS, Win32)

endhostent

Not implemented. (Android, Win32)

実装されていません。 (Android, Win32)

endnetent

Not implemented. (Android, Win32, Plan 9)

実装されていません。 (Android, Win32, Plan 9)

endprotoent

Not implemented. (Android, Win32, Plan 9)

実装されていません。 (Android, Win32, Plan 9)

endservent

Not implemented. (Plan 9, Win32)

実装されていません。 (Plan 9, Win32)

getsockopt SOCKET,LEVEL,OPTNAME

Not implemented. (Plan 9)

実装されていません。 (Plan 9)

glob

This operator is implemented via the File::Glob extension on most platforms. See File::Glob for portability information.

この演算子はほとんどのプラットフォームでは File::Glob エクステンションで 実装されています。 移植性の情報については File::Glob を参照してください。

gmtime

In theory, gmtime() is reliable from -2**63 to 2**63-1. However, because work arounds in the implementation use floating point numbers, it will become inaccurate as the time gets larger. This is a bug and will be fixed in the future.

理論的には、gmtime() は -2**63 から 2**63-1 の範囲で信頼性があります。 しかし、実装で浮動小数点数を使っているので、値が大きくなるにつれて 不正確になります。 これはバグで、詳細修正されます。

On VOS, time values are 32-bit quantities.

VOS では、時刻の値は 32-bit です。

ioctl FILEHANDLE,FUNCTION,SCALAR

Not implemented. (VMS)

実装されていません。 (VMS)

Available only for socket handles, and it does what the ioctlsocket() call in the Winsock API does. (Win32)

ソケットハンドルに対してのみ利用可能で、Winsock API の ioctlsocket() 呼び出しですることをします。 (Win32)

Available only for socket handles. (RISC OS)

ソケットハンドルに対してのみ利用可能です。 (RISC OS)

kill

Not implemented, hence not useful for taint checking. (RISC OS)

汚染チェックには有用ではないので、実装されていません。 (RISC OS)

kill() doesn't have the semantics of raise(), i.e. it doesn't send a signal to the identified process like it does on Unix platforms. Instead kill($sig, $pid) terminates the process identified by $pid, and makes it exit immediately with exit status $sig. As in Unix, if $sig is 0 and the specified process exists, it returns true without actually terminating it. (Win32)

kill()raise() の動作はありません; つまり、 Unix プラットフォームで行われるように識別されたプロセスへシグナルを 送りません。 代わりに kill($sig, $pid)$pid で識別されるプロセスを終了させ、 終了コード $sig で直ちに終了させます。 Unix でのように、$sig が 0 で指定されたプロセスが存在するなら、実際には 終了させずに真を返します。 (Win32)

kill(-9, $pid) will terminate the process specified by $pid and recursively all child processes owned by it. This is different from the Unix semantics, where the signal will be delivered to all processes in the same process group as the process specified by $pid. (Win32)

kill(-9, $pid)$pid で指定されたプロセスと、そのプロセスが 所有している全ての子プロセスを再帰的に終了させます。 これは、$pid で指定されたプロセスと同じプロセスグループの全ての プロセスにシグナルを送信する、という Unix での動作と異なります。 (Win32)

Is not supported for process identification number of 0 or negative numbers. (VMS)

プロセス識別番号 0 や負数は対応していません。 (VMS)

link

Not implemented. (RISC OS, VOS)

実装されていません。 (RISC OS, VOS)

Link count not updated because hard links are not quite that hard (They are sort of half-way between hard and soft links). (AmigaOS)

ハードリンクは完全にハードではないので、リンクカウントは更新されません (これはハードリンクとソフトリンクの中間のようなものです)。 (AmigaOS)

Hard links are implemented on Win32 under NTFS only. They are natively supported on Windows 2000 and later. On Windows NT they are implemented using the Windows POSIX subsystem support and the Perl process will need Administrator or Backup Operator privileges to create hard links.

ハードリンクは NTFS の Win32 にのみ実装されています。 これは Windows 2000 以降でネイティブに対応しています。 Windows NT では Windows POSIX サブシステムサポートを使って 実装されていて、Perl プロセスはハードリンクを作るには Administrator または Backup Operator 権限が必要です。

Available on 64 bit OpenVMS 8.2 and later. (VMS)

64 ビット OpenVMS 8.2 以降で利用可能です。 (VMS)

localtime

localtime() has the same range as "gmtime", but because time zone rules change its accuracy for historical and future times may degrade but usually by no more than an hour.

localtime() は "gmtime" と同じ範囲を持ちます; しかしタイムゾーンの 変更により過去および未来の精度は劣化するかもしれませんが、普通は 1 時間以内です。

lstat

Not implemented. (RISC OS)

実装されていません。 (RISC OS)

Return values (especially for device and inode) may be bogus. (Win32)

返り値 (特にデバイスと i ノード) は偽物かもしれません。 (Win32)

msgctl
msgget
msgsnd
msgrcv

Not implemented. (Android, Win32, VMS, Plan 9, RISC OS, VOS)

実装されていません。 (Android, Win32, VMS, Plan 9, RISC OS, VOS)

open

open to |- and -| are unsupported. (Win32, RISC OS)

|--| へのオープンは対応していません。 (Win32, RISC OS)

Opening a process does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX)

プロセスをオープンしたときに一部のプラットフォームでは出力ハンドルを自動的に フラッシュしません。 (SunOS, Solaris, HP-UX)

readlink

Not implemented. (Win32, VMS, RISC OS)

実装されていません。 (Win32, VMS, RISC OS)

rename

Can't move directories between directories on different logical volumes. (Win32)

異なった論理ボリュームのディレクトリの間ではディレクトリは移動できません。 (Win32)

rewinddir

Will not cause readdir() to re-read the directory stream. The entries already read before the rewinddir() call will just be returned again from a cache buffer. (Win32)

ディレクトリストリームの再読み込みに readdir() を行いません。 rewinddir() 呼び出しの前に既に読み込まれているエントリは再び キャッシュバッファから返されます。 (Win32)

select

Only implemented on sockets. (Win32, VMS)

ソケットに対してのみ実装されています。 (Win32, VMS)

Only reliable on sockets. (RISC OS)

ソケットに対してのみ信頼できます。 (RISC OS)

Note that the select FILEHANDLE form is generally portable.

select FILEHANDLE 形式は一般的に移植性があることに注意してください。

semctl
semget
semop

Not implemented. (Android, Win32, VMS, RISC OS)

実装されていません。 (Android, Win32, VMS, RISC OS)

setgrent

Not implemented. (Android, VMS, Win32, RISC OS)

実装されていません。 (Android, VMS, Win32, RISC OS)

setpgrp

Not implemented. (Win32, VMS, RISC OS, VOS)

実装されていません。 (Win32, VMS, RISC OS, VOS)

setpriority

Not implemented. (Win32, VMS, RISC OS, VOS)

実装されていません。 (Win32, VMS, RISC OS, VOS)

setpwent

Not implemented. (Android, Win32, RISC OS)

実装されていません。 (Android, Win32, RISC OS)

setsockopt

Not implemented. (Plan 9)

実装されていません。 (Plan 9)

shmctl
shmget
shmread
shmwrite

Not implemented. (Android, Win32, VMS, RISC OS)

実装されていません。 (Android, Win32, VMS, RISC OS)

sleep

Emulated using synchronization functions such that it can be interrupted by alarm(), and limited to a maximum of 4294967 seconds, approximately 49 days. (Win32)

alarm() で割り込みできるように同期関数を使ってエミュレートされていて、 最大 4294967 秒、およそ 49 日に制限されています。 (Win32)

sockatmark

A relatively recent addition to socket functions, may not be implemented even in Unix platforms.

比較的最近に追加されたソケット関数で、Unix プラットフォームであっても 実装されていないかもしれません。

socketpair

Not implemented. (RISC OS)

実装されていません。 (RISC OS)

Available on 64 bit OpenVMS 8.2 and later. (VMS)

64 ビット OpenVMS 8.2 以降で利用可能です。 (VMS)

stat

Platforms that do not have rdev, blksize, or blocks will return these as '', so numeric comparison or manipulation of these fields may cause 'not numeric' warnings.

rdev, blksize, blocks がないプラットフォームではこれらは '' を返すので、 これらのフィールドの数値での比較や操作は 'not numeric' 警告を 引き起こします。

ctime not supported on UFS (Mac OS X).

ctime は UFS では対応していません。 (Mac OS X)

ctime is creation time instead of inode change time (Win32).

ctime は i ノード変更時刻ではなく作成時刻です。 (Win32)

device and inode are not meaningful. (Win32)

デバイスと i ノードは無意味です。 (Win32)

device and inode are not necessarily reliable. (VMS)

デバイスと i ノードは信頼できる必要がありません。 (VMS)

mtime, atime and ctime all return the last modification time. Device and inode are not necessarily reliable. (RISC OS)

mtime, atime, ctime は全て最終更新時刻を返します。 デバイスと i ノードは信頼する必要はありません。 (RISC OS)

dev, rdev, blksize, and blocks are not available. inode is not meaningful and will differ between stat calls on the same file. (os2)

dev, rdev, blksize, blocks は利用できません。 inode は無意味で、同じファイルで stat 呼び出しの間でも異なります。 (os2)

some versions of cygwin when doing a stat("foo") and if not finding it may then attempt to stat("foo.exe") (Cygwin)

cygwin の一部のバージョンでは、stat("foo") を実行して、もし 見付からなければ stat("foo.exe") を実行しようとします。 (Cygwin)

On Win32 stat() needs to open the file to determine the link count and update attributes that may have been changed through hard links. Setting ${^WIN32_SLOPPY_STAT} to a true value speeds up stat() by not performing this operation. (Win32)

Win32 では stat() は、リンクカウントと、ハードリンクを通して 変更されるかもしれない属性の更新にはファイルを開く必要があります。 ${^WIN32_SLOPPY_STAT} を真の値に設定することで、この操作をしないことで stat() を高速化します。 (Win32)

symlink

Not implemented. (Win32, RISC OS)

実装されていません。 (Win32, RISC OS)

Implemented on 64 bit VMS 8.3. VMS requires the symbolic link to be in Unix syntax if it is intended to resolve to a valid path.

64 ビット VMS 8.3 で実装されています。 VMS は、有効なパスを解決することを目的としているなら、シンボリックリンクが Unix の文法であることが必要です。

syscall

Not implemented. (Win32, VMS, RISC OS, VOS)

実装されていません。 (Win32, VMS, RISC OS, VOS)

sysopen

The traditional "0", "1", and "2" MODEs are implemented with different numeric values on some systems. The flags exported by Fcntl (O_RDONLY, O_WRONLY, O_RDWR) should work everywhere though. (Mac OS, OS/390)

伝統的な "0", "1", "2" の MODE は一部のシステムでは異なる数値で 実装されています。 しかし、Fcntl でエクスポートされるフラグ (O_RDONLY, O_WRONLY, O_RDWR) は どこでも動作するはずです。 (Mac OS, OS/390)

system

As an optimization, may not call the command shell specified in $ENV{PERL5SHELL}. system(1, @args) spawns an external process and immediately returns its process designator, without waiting for it to terminate. Return value may be used subsequently in wait or waitpid. Failure to spawn() a subprocess is indicated by setting $? to "255 << 8". $? is set in a way compatible with Unix (i.e. the exitstatus of the subprocess is obtained by "$? 8">>, as described in the documentation). (Win32)

最適化として、$ENV{PERL5SHELL} で指定されたコマンドシェルを 呼び出さないかもしれません。 system(1, @args) は外部プロセスを起動して、その終了を待たず、 直ちにそのプロセス指定子を返します。 返り値は引き続く waitwaitpid で使えます。 サブプロセスの spawn() の失敗は、$?"255 << 8" を設定することで 示されます。 $? は Unix と互換性のある方法 (つまり、サブプロセスの終了ステータスは 文書に記述されている通りに "$? 8">> で得られる) で設定されます。 (Win32)

There is no shell to process metacharacters, and the native standard is to pass a command line terminated by "\n" "\r" or "\0" to the spawned program. Redirection such as > foo is performed (if at all) by the run time library of the spawned program. system list will call the Unix emulation library's exec emulation, which attempts to provide emulation of the stdin, stdout, stderr in force in the parent, providing the child program uses a compatible version of the emulation library. scalar will call the native command line direct and no such emulation of a child Unix program will exists. Mileage will vary. (RISC OS)

メタ文字を処理するシェルはなく、ネイティブな標準では "\n", "\r", "\0" で終端されたコマンドラインを spawn したプログラムに 渡します。 > foo のようなリダイレクトは spawn したプログラムの ランタイムライブラリによって実行されます。 system list は Unix エミュレーションライブラリの exec エミュレーションを呼び出し、子プログラムがエミュレーションライブラリの 互換版を使っているなら、親の stdin, stdout, stderr をエミュレーションを 提供しようとします。 scalar はネイティブなコマンドラインを直接呼び出し、子 Unix プログラムの エミュレーションは存在しません。 これは状況によって 異なります。 (RISC OS)

system LIST without the use of indirect object syntax (system PROGRAM LIST) may fall back to trying the shell if the first spawn() fails. (Win32)

間接オブジェクト構文 (system PROGRAM LIST) を使わない system LIST は、 最初の spawn() が失敗したときにシェルにフォールバックすることがあります。 (Win32)

Does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX)

一部のプラットフォームでは出力ハンドルを自動的にフラッシュしません。 (SunOS, Solaris, HP-UX)

The return value is POSIX-like (shifted up by 8 bits), which only allows room for a made-up value derived from the severity bits of the native 32-bit condition code (unless overridden by use vmsish 'status'). If the native condition code is one that has a POSIX value encoded, the POSIX value will be decoded to extract the expected exit value. For more details see "$?" in perlvms. (VMS)

返り値は POSIX 風 (8 ビットシフト) で、(use vmsish 'status' で 上書きされない限り)ネイティブな 32 ビット条件コードの重大度ビットから 作り上げられた値のための場所だけがあります。 ネイティブな条件コードが POSIX 値をエンコードしたものなら、 POSIX 値は想定される終了コードを展開するためにデコードされます。 さらなる詳細については "$?" in perlvms を参照してください。 (VMS)

telldir

Not implemented. (Android)

実装されていません。 (Android)

times

"cumulative" times will be bogus. On anything other than Windows NT or Windows 2000, "system" time will be bogus, and "user" time is actually the time returned by the clock() function in the C runtime library. (Win32)

「累積」時間は偽りかもしれません。 Windows NT と Windows 2000 以外では、「システム」時間は偽りかもしれず、 「ユーザ」時間は実際には C ランタイムライブラリの clock() 関数から かえされた時刻です。 (Win32)

Not useful. (RISC OS)

使い道はありません。 (RISC OS)

truncate

Not implemented. (Older versions of VMS)

実装されていません。 (Older versions of VMS)

Truncation to same-or-shorter lengths only. (VOS)

同じかより短い長さへの切り詰めのみです。 (VOS)

If a FILEHANDLE is supplied, it must be writable and opened in append mode (i.e., use open(FH, '>>filename') or sysopen(FH,...,O_APPEND|O_RDWR). If a filename is supplied, it should not be held open elsewhere. (Win32)

FILEHANDLE が指定されると、それは書き込み可能で、追記モード (つまり open(FH, '>>filename') または sysopen(FH,...,O_APPEND|O_RDWR) を使っている)でなければなりません。 ファイル名が指定されると、他で開いていてはいけません。 (Win32)

umask

Returns undef where unavailable.

利用不可能な場合は undef を返します。

umask works but the correct permissions are set only when the file is finally closed. (AmigaOS)

umask は動作しますが、正しい権限はファイルが最終的に閉じられたときにのみ 設定されます。 (AmigaOS)

utime

Only the modification time is updated. (VMS, RISC OS)

修正時刻が更新されたときのみです。 (VMS, RISC OS)

May not behave as expected. Behavior depends on the C runtime library's implementation of utime(), and the filesystem being used. The FAT filesystem typically does not support an "access time" field, and it may limit timestamps to a granularity of two seconds. (Win32)

想定した通りに動作しないかもしれません。 振る舞いは C ランタイムライブラリの utime() の実装と、使われる ファイルシステムに依存します。 FAT ファイルシステムは典型的には「アクセス時刻」フィールドに 対応しておらず、タイムスタンプの精度が 2 秒に制限されているかも しれません。 (Win32)

wait
waitpid

Can only be applied to process handles returned for processes spawned using system(1, ...) or pseudo processes created with fork(). (Win32)

system(1, ...) を使って作成されたプロセスか、fork() で作成された 疑似プロセスで返されたプロセスハンドルに対してのみ適用できます。 (Win32)

Not useful. (RISC OS)

使い道はありません。 (RISC OS)

対応しているプラットフォーム

The following platforms are known to build Perl 5.12 (as of April 2010, its release date) from the standard source code distribution available at http://www.cpan.org/src

以下のプラットフォームは (リリース日である 2010 年 4 月時点で) http://www.cpan.org/src で利用可能な標準ソースコード配布から Perl 5.12 を ビルドしていることが知られています

Linux (x86, ARM, IA64)
HP-UX
AIX
Win32
Windows 2000
Windows XP
Windows Server 2003
Windows Vista
Windows Server 2008
Windows 7
Cygwin

Some tests are known to fail:

Solaris (x86, SPARC)
OpenVMS
Alpha (7.2 and later)
I64 (8.2 and later)
Symbian
NetBSD
FreeBSD
Debian GNU/kFreeBSD
Haiku
Irix (6.5. What else?)
OpenBSD
Dragonfly BSD
Midnight BSD
QNX Neutrino RTOS (6.5.0)
MirOS BSD
Stratus OpenVOS (17.0 or later)

Caveats:

注意:

time_t issues that may or may not be fixed

(time_t の問題は修正されているかもしれませんしされていないかもしれません)

Symbian (Series 60 v3, 3.2 and 5 - what else?)
Stratus VOS / OpenVOS
AIX
Android
FreeMINT

Perl now builds with FreeMiNT/Atari. It fails a few tests, that needs some investigation.

Perl は FreeMiNT/Atari でビルド出来るようになりました。 いくつかのテストは失敗するので、調査が必要です。

The FreeMiNT port uses GNU dld for loadable module capabilities. So ensure you have that library installed when building perl.

FreeMiNT 版は読み込み可能モジュール機能のために GNU dld を使っています。 従って、perl をビルドするときにこのライブラリがあることを確認してください。

EOL プラットフォーム

(Perl 5.20)

The following platforms were supported by a previous version of Perl but have been officially removed from Perl's source code as of 5.20:

以下のプラットフォームは以前のバージョンの Perl では対応していましたが 5.20 の時点で Perl のソースコードから公式に取り除かれました:

AT&T 3b1

(Perl 5.14)

The following platforms were supported up to 5.10. They may still have worked in 5.12, but supporting code has been removed for 5.14:

以下のプラットフォームは 5.10 まで対応していました。 5.12 でもまだ動作していましたが、対応コードは 5.14 で取り除かれました:

Windows 95
Windows 98
Windows ME
Windows NT4

(Perl 5.12)

The following platforms were supported by a previous version of Perl but have been officially removed from Perl's source code as of 5.12:

以下のプラットフォームは以前のバージョンの Perl では対応していましたが 5.12 の時点で Perl のソースコードから公式に取り除かれました:

Atari MiNT
Apollo Domain/OS
Apple Mac OS 8/9
Tenon Machten

対応していたプラットフォーム (Perl 5.8)

As of July 2002 (the Perl release 5.8.0), the following platforms were able to build Perl from the standard source code distribution available at http://www.cpan.org/src/

2002 年 7 月 (Perl リリース 5.8.0) 現在、以下のプラットフォームが http://www.cpan.org/src/ から利用可能な標準ソースコード配布から ビルド可能でした:

        AIX
        BeOS
        BSD/OS          (BSDi)
        Cygwin
        DG/UX
        DOS DJGPP       1)
        DYNIX/ptx
        EPOC R5
        FreeBSD
        HI-UXMPP        (Hitachi) (5.8.0 worked but we didn't know it)
        HP-UX
        IRIX
        Linux
        Mac OS Classic
        Mac OS X        (Darwin)
        MPE/iX
        NetBSD
        NetWare
        NonStop-UX
        ReliantUNIX     (formerly SINIX)
        OpenBSD
        OpenVMS         (formerly VMS)
        Open UNIX       (Unixware) (since Perl 5.8.1/5.9.0)
        OS/2
        OS/400          (using the PASE) (since Perl 5.8.1/5.9.0)
        PowerUX
        POSIX-BC        (formerly BS2000)
        QNX
        Solaris
        SunOS 4
        SUPER-UX        (NEC)
        Tru64 UNIX      (formerly DEC OSF/1, Digital UNIX)
        UNICOS
        UNICOS/mk
        UTS
        VOS / OpenVOS
        Win95/98/ME/2K/XP 2)
        WinCE
        z/OS            (formerly OS/390)
        VM/ESA

        1) in DOS mode either the DOS or OS/2 ports can be used
        2) compilers: Borland, MinGW (GCC), VC6

The following platforms worked with the previous releases (5.6 and 5.7), but we did not manage either to fix or to test these in time for the 5.8.0 release. There is a very good chance that many of these will work fine with the 5.8.0.

以下のプラットフォームは以前のリリース (5.6 と 5.7) で動作していましたが、 5.8.0 リリースのときに修正やテストができませんでした。 これらの多くは 5.8.0 でうまく動く可能性がかなりあります。

        BSD/OS
        DomainOS
        Hurd
        LynxOS
        MachTen
        PowerMAX
        SCO SV
        SVR4
        Unixware
        Windows 3.1

Known to be broken for 5.8.0 (but 5.6.1 and 5.7.2 can be used):

5.8.0 で壊れていることが知られています (しかし 5.6.1 と 5.7.2 は使えます):

        AmigaOS

The following platforms have been known to build Perl from source in the past (5.005_03 and earlier), but we haven't been able to verify their status for the current release, either because the hardware/software platforms are rare or because we don't have an active champion on these platforms--or both. They used to work, though, so go ahead and try compiling them, and let perlbug@perl.org of any trouble.

以下のプラットフォームは過去 (5.005_03 以前) にソースから Perl を ビルドしたことが知られていますが、現在のリリースに対する状況を 確認できません; ハードウェア/ソフトウェアプラットフォームがレアなものか、 これらのプラットフォームに対するアクティブな推進者がいないか、 あるいはその両方が理由です。 しかし以前は動いていたので、ぜひコンパイルしてみて、 perlbug@perl.org に 問題点を知らせてください。

        3b1
        A/UX
        ConvexOS
        CX/UX
        DC/OSx
        DDE SMES
        DOS EMX
        Dynix
        EP/IX
        ESIX
        FPS
        GENIX
        Greenhills
        ISC
        MachTen 68k
        MPC
        NEWS-OS
        NextSTEP
        OpenSTEP
        Opus
        Plan 9
        RISC/os
        SCO ODT/OSR
        Stellar
        SVR2
        TI1500
        TitanOS
        Ultrix
        Unisys Dynix

The following platforms have their own source code distributions and binaries available via http://www.cpan.org/ports/

以下のプラットフォームは http://www.cpan.org/ports/ 経由で独自の ソースコード配布とバイナリが利用可能です:

                                Perl release

        OS/400 (ILE)            5.005_02
        Tandem Guardian         5.004

The following platforms have only binaries available via http://www.cpan.org/ports/index.html :

以下のプラットフォームは http://www.cpan.org/ports/index.html 経由で バイナリのみが利用可能です:

                                Perl release

        Acorn RISCOS            5.005_02
        AOS                     5.002
        LynxOS                  5.004_02

Although we do suggest that you always build your own Perl from the source code, both for maximal configurability and for security, in case you are in a hurry you can check http://www.cpan.org/ports/index.html for binary distributions.

しかし、私たちは、最大限の設定可能性とセキュリティの両方のために、 常にあなた自身の Perl をソースからビルドすることを提案しています; 急いでいる場合には http://www.cpan.org/ports/index.html にある バイナリ配布をチェックしてください。

SEE ALSO

perlaix, perlamiga, perlbs2000, perlce, perlcygwin, perldos, perlebcdic, perlfreebsd, perlhurd, perlhpux, perlirix, perlmacos, perlmacosx, perlnetware, perlos2, perlos390, perlos400, perlplan9, perlqnx, perlsolaris, perltru64, perlunicode, perlvms, perlvos, perlwin32, Win32

AUTHORS / CONTRIBUTORS

Abigail <abigail@foad.org>, Charles Bailey <bailey@newman.upenn.edu>, Graham Barr <gbarr@pobox.com>, Tom Christiansen <tchrist@perl.com>, Nicholas Clark <nick@ccl4.org>, Thomas Dorner <Thomas.Dorner@start.de>, Andy Dougherty <doughera@lafayette.edu>, Dominic Dunlop <domo@computer.org>, Neale Ferguson <neale@vma.tabnsw.com.au>, David J. Fiander <davidf@mks.com>, Paul Green <Paul.Green@stratus.com>, M.J.T. Guy <mjtg@cam.ac.uk>, Jarkko Hietaniemi <jhi@iki.fi>, Luther Huffman <lutherh@stratcom.com>, Nick Ing-Simmons <nick@ing-simmons.net>, Andreas J. König <a.koenig@mind.de>, Markus Laker <mlaker@contax.co.uk>, Andrew M. Langmead <aml@world.std.com>, Larry Moore <ljmoore@freespace.net>, Paul Moore <Paul.Moore@uk.origin-it.com>, Chris Nandor <pudge@pobox.com>, Matthias Neeracher <neeracher@mac.com>, Philip Newton <pne@cpan.org>, Gary Ng <71564.1743@CompuServe.COM>, Tom Phoenix <rootbeer@teleport.com>, André Pirard <A.Pirard@ulg.ac.be>, Peter Prymmer <pvhp@forte.com>, Hugo van der Sanden <hv@crypt0.demon.co.uk>, Gurusamy Sarathy <gsar@activestate.com>, Paul J. Schinder <schinder@pobox.com>, Michael G Schwern <schwern@pobox.com>, Dan Sugalski <dan@sidhe.org>, Nathan Torkington <gnat@frii.com>, John Malmberg <wb8tyw@qsl.net>