file_get_linkTarget

指定したファイルリンクのリンク先を取得します。

taiseiue | 2024-05-02
  • 共有
  •  記事の編集

定義

名前空間: Alice.IO
アセンブリ: Losetta.Runtime.dll
ソースコード: Alice.IO.cs

file_get_linkTarget(string,bool)

プレビュー

この記事では、現在開発中のAlice vNEXTに実装される予定のAPIについて説明しています。 このAPIは予告なく削除および変更される可能性があります。

指定したファイルリンクのリンク先を取得します。

AliceScript
namespace Alice.IO;
public string file_get_linkTarget(string path, bool getFinalTarget);
引数
path リンク先を取得するファイルリンクへのパス
getFinalTarget ファイルの実体にたどり着くまで再帰的に取得する場合はtrue、それ以外の場合はfalse
戻り値
string pathのリンク先へのパス。ただし、pathがリンクではない場合はnull。

対応
AliceScript
AliceSister
Losetta

この関数はAliceScript、AliceSisterでは実装されていません。

実装されていない環境では0x034 NOT_IMPLEMENTED例外がスローされます。

説明

この関数は、シンボリックリンクまたはジャンクションのリンク先を絶対パスで取得します。

getFinalTargetがtrueの場合、この関数はファイルの実体にたどり着くまで再帰的にリンク先を取得しようとします。ただし、たどるリンクの数がUnixで40個以上、Windowsで63個以上の場合は例外が発生します。

pathには、相対パスと絶対パスのどちらでも指定できます。 相対パスを指定した場合、カレントディレクトリからの相対パスとして解釈します。 パスの大文字と小文字の区別は、環境およびファイルシステムに依存します。たとえば、NTFSでは大文字と小文字は区別されませんが、LFSでは大文字と小文字が区別されます。

例

次の例では、link.txtのリンク先を表示しています。

AliceScript
using Alice.IO;

print(file_get_linkTarget("link.txt", true));