url: リンク先を示します。

linked: url に相対的な、リンクされるオブジェクトへのパスです。

error-if-exists?: ファイルがすでに url に存在する場合に例外がスローされるかどうかを示すフラグで、以下のようになります。

• true (既定値) に設定すると、ファイルが url にすでに存在する場合は IOException がスローされます。
• false に設定すると、url のファイルが自動的に上書きされます。

url で指定されたオブジェクトが Directory である場合、このパラメータの値に関係なく例外がスローされます。

シンボリック リンクは、ファイルシステム内の別のファイルまたはディレクトリを参照するファイルシステム内のオブジェクトです。すべてのファイルシステムでシンボリック リンクの概念がサポートサポートされているわけではないので、プラットフォームによってはこのプロシージャが機能しない場合があります。

linked の存在を調べないので、このプロシージャでは壊れたシンボリック リンクが作成される場合があります。

例外のスロー

このプロシージャはアトミックではありません。

error-if-exists? = false を指定してもこのプロシージャが ExistingFileException をスローしないとは限りません。たとえば、別のプロセスがタイミング悪くファイルシステムに url で指定したオブジェクトを作成した場合などにはエラーがスローされます。