カレントワーキングディレクトリを変更します。

構文

int f_chdir(
  const char *path
);

パラメータ

path
[in] ディレクトリのパスを表す文字列を指すポインタ。

戻り値

 関数が成功したら0を,それ以外は0以外を返します。

解説

 カレントワーキングディレクトリをpathで指定したディレクトリに変更します。
 カレントワーキングディレクトリは、"/" で始まらない相対パスの指定を解釈するときの開始点です。
 カレントワーキングディレクトリの初期値は "1:/" (ルートディレクトリ)です。

(注意)

 カレントワーキングディレクトリに指定されているディレクトリは削除できません。

必要条件

ヘッダファイル:
lib.h
ライブラリファイル:
libSTARTUPOPH5000.a

サンプル

#include <stdio.h>
#include "lib.h"

void main(void)
{
    // Current working directory(CWD) = "1:/"

    f_mkdir("1:/DIR1");       // absolute path: Create "1:/DIR1"
    f_mkdir("1:/DIR1/DIR2");  // absolute path: Create "1:/DIR1/DIR2"

    f_mkdir("DIR3");          // relative path: Create "1:/DIR3"

    f_chdir("DIR3");          // relative path: Change CWD to "1:/DIR3"

    f_mkdir("DIR4");          // relative path: Create "1:/DIR3/DIR4"

    remove("DIR4");           // relative oath: Delete "1:/DIR3/DIR4"

    f_chdir("1:/");           // absolute path: Change CWD to"1:/"

    remove("1:/DIR3");        // absolute path: Delete "1:/DIR3"

    f_chdir("/DIR1");         // absolute path without drive identifier: Change CWD to "1:/DIR1"

    remove("DIR2");           // relative path: Delete "1:DIR1/DIR2"

    f_chdir("/");             // absolute path without drive identifier: Change CWD to "1:/"

    remove("/DIR1");          // absolute path without drive identifier: Delete "1:DIR1"

    while(1){
        Idle();
    }
}

関連事項

最終更新日:2020/11/14