unsetenv() - 環境変数の削除

標準

標準/拡張機能 C/C++ 依存項目

Single UNIX Specification、バージョン 3

両方

z/OS V1R7

形式

#define _UNIX03_SOURCE
#include <stdlib.h>

int unsetenv(const char *name);

機能説明

unsetenv() は、呼び出しプロセスの環境から環境変数を削除します。name 引数はストリングを示し、このストリングは除去する変数の名前です。name によって示されたストリングが「=」文字を含んでいる場合、unsetenv() は失敗します。指定された変数が現行環境に存在しない場合、環境は変更されず、unsetenv() は正常に実行されます。

戻り値

正常に実行された場合、unsetenv() は 0 を戻します。正常に実行されなかった場合、unsetenv() は -1 を戻し、エラーを示す errno を設定します。
  • EINVAL - name 引数が NULL ポインターであるか、空ストリングを指しているか、または「=」文字を含むストリングを指しています。

関連情報