getwd サブルーチン

オンライン編集

目的

現行ディレクトリー・パス名を取得します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <unistd.h>

char *getwd ( PathName)
char *PathName;

説明

getwd サブルーチンは、現行ディレクトリーの絶対パス名を判別してから、そのパス名を PathName パラメーターが指す領域にコピーします。

パス名の最大長 (文字数) は、 limits.h ファイルに指定されているように、 PATH_MAX 値によって設定されます。

パラメーター

項目 説明
PathName 絶対パス名を指します。

戻り値

getwd サブルーチンの呼び出しが成功すると、現行ディレクトリーの絶対パス名へのポインターが戻されます。 エラーが発生すると、 getwd サブルーチンはヌル値を戻し、エラー・メッセージを PathName パラメーターに入れます。

UNIX03 モードでは、実際のパス名が PATH_MAXで定義された値より長い場合、 getwd サブルーチンはヌル値を戻します。 前のモードでは、パス名が PATH_MAXより長い場合、 getwd サブルーチンは切り捨てられたパス名を戻します。 以前の動作は、環境変数 XPG_SUS_ENV=ON を設定して使用不可にすることができます。