MHCにおけるディレクトリ操作関数のそれぞれの役目と違いについて

Question

前提・実現したいこと

MHC（MPLAB Harmony Core）のディレクトリ操作関数のうち下記２関数につきまして質問がございます。
・SYS_FS_HANDLE SYS_FS_DirOpen(const char* path);
・SYS_FS_RESULT SYS_FS_DirectoryChange(const char* path);
SYS_FS_DirOpenは指定されたディレクトリを開く関数、SYS_FS_DirectoryChangeは指定されたディレクトリに移動する関数との記載がMPLAB Harmony Core Helpに有りました。
どちらもディレクトリ移動という同じ動作を実行しているように思えますが、これらの動作の違いは何でしょうか？
ご存じの方はご教授よろしくおねがいいたします。

補足情報（FW/ツールのバージョンなど）

参考ページ
https://microchip-mplab-harmony.github.io/core/frames.html?frmname=topic&frmfile=00926.html

Answer 1

私は MHC というものに詳しいわけではないということは事前にお断りしておきますが、ドキュメントから読み取れる限りでは SYS_FS_DirOpen を移動と考えるべきではないです。 ファイルハンドルを開くのと同じ感覚でディレクトリのハンドルを開いているわけで、ディレクトリに対応付いているハンドルが返却値として返されます。 状態に変化を及ぼしてはいません。 何も移動していません。

SYS_FS_DirectoryChange はカレントディレクトリを変更するもので、返却値は成功か失敗かを返すだけです。 ただ、ドキュメント内では表現が current working directory だったり present directory だったりして言葉の揺らぎがあるようです。 (ひょっとすると厳密には使い分けていたりするのかも？)

Comments

[teratail2020]

回答ありがとうございます。SYS_FS_DirOpenで得られたハンドルは、ディレクトリ内のファイル毎のプロパティ取得関数SYS_FS_DirRead、指定されたファイルの有無を確認する関数SYS_FS_DirSearch、および前述２つの関数の動作起点初期化関数SYS_FS_DirRewindに用いられると認識していますが、これらの作業を行っている対象ディレクトリがカレントディレクトリなのでは無いでしょうか？ならばSYS_FS_DirectoryChangeやSYS_FS_CurrentWorkingDirectoryGetの引数にもディレクトリハンドルが必要な気がします…。それが無いということはディレクトリハンドルに関連付けられた作業ディレクトリとカレントディレクトリは別物になるのではと考えています。その場合カレントディレクトリは何なのかがわからない状態です。

[SaitoAtsushi]

> これらの作業を行っている対象ディレクトリがカレントディレクトリなのでは無いでしょうか？

カレントディレクトリはグローバルな (といっても普通はプロセス毎に) 状態として保持されます。 前提を確認するのですが、 Windows や Linux でいうところのカレントディレクトリという概念についてはご存じですか？

[jimbe]

私も MHC は知りませんのでドキュメントと想像からです。

> ディレクトリ内のファイル毎のプロパティ取得関数SYS_FS_DirRead、 ～ 、これらの作業を行っている対象ディレクトリがカレントディレクトリなのでは無いでしょうか？

SYS_FS_DirOpen でオープン時にパスを指定して得たハンドルを用いて動作するようですので、それらの関数の対象は「カレントディレクトリ」では無いものとと思います。

「カレントディレクトリ」とは、パスを指定する場合に相対パスを指定した時の起点となるディレクトリでしょう。
その「カレントディレクトリ」を変更するのが、 SYS_FS_DirectoryChange ではないでしょうか。

[teratail2020]

>jimbe つまりSYS_FS_DirOpenの引数とする相対パスの起点をSYS_FS_CurrentWorkingDirectoryGet によって得たり、SYS_FS_DirectoryChangeによって適切なディレクトリに変更する関数であるとの認識でよろしいでしょうか？

[jimbe]

SYS_FS_CurrentWorkingDirectoryGet 関数が「"カレントディレクトリ"の文字列表現を返す(buff にセットする)モノ」のでしたら、試してみるのが一番かと思います。
SaitoAtsushi さんが回答で"言葉の揺らぎ"と言われていますように、「カレントディレクトリ」と「CurrentWorkingDirectory」が同じものかはドキュメントの一部分を呼んだだけでは分かりかねます。

[SaitoAtsushi]

ドキュメント上で SYS_FS_CurrentWorkingDirectoryGet の使用例 (example) として書かれているものを見ると SYS_FS_DirectoryChange で変更したものが SYS_FS_CurrentWorkingDirectoryGet で得られるということについては疑う余地はないでしょう。

関数の使い方はそれでよいとして、用語の使い方というのは同じものが状況というか考え方によって別の名前で呼ばれるのはごく普通にあることなので、全体の構造を理解しないと正確なことが言えません。 たとえばプログラム言語の解釈において字句レイヤで識別子と呼ばれているものが構文レイヤではクラス名だったり変数名だったりするわけです。 同じものが視点によって名前が変わります。 違う用語を使っているというのが違う意味付けを持っているのか単に雑なのかは部分的に見てもよくわからないんです。

個人的には単に用語法を整理せずに書いている印象を受けてはいますが……。

[teratail2020]

各位
回答ありがとうございます。正確性を確保するためにはjimbe様のご指摘通りに実機試験を行うのが確実です。
しかしながら基板が未作成状態であるため、現在実機試験ができません。以上を踏まえましても「「カレントディレクトリ」とは、パスを指定する場合に相対パスを指定した時の起点となるディレクトリでしょう。」の回答通りに捉えますとすべての関数の役割と説明の内容が腑に落ちます。ご教授下さりありがとうございました。