tuxputenv(3c)

名前

tuxputenv()-環境の値を変更、または値を環境に追加する

形式

#include <atmi.h>
int tuxputenv(char *string)

機能説明

string は、"name=value" という形式の文字列を指すようにします。tuxputenv() は、環境変数名の値を、既存の変数を変更するか、新しい変数を作成することで値と等しくします。どちらの場合も、string によって指された文字列は環境変数の一部になります。

この関数は、BEA Tuxedo ATMI がサポートされる、異なるプラットフォーム間で使用する環境変数に対して、移植可能なインターフェイスを提供します。プラットフォームには、通常は環境変数を持たないプラットフォームも含まれます

tuxputenv() は大文字と小文字を区別することに注意してください。

マルチスレッドのアプリケーション中のスレッドは、TPINVALIDCONTEXT を含め、どのコンテキスト状態で実行していても tuxputenv() の呼び出しを発行できます。

戻り値

tuxputenv() は、malloc() を介して拡張環境のための十分な領域を獲得できなかった場合にゼロでない整数を返します。領域を獲得できた場合はゼロを返します。

移植性

MS Windows では、この関数によって、アプリケーションとダイナミック・リンク・ライブラリとの間で環境変数を共有できるようになります。BEA Tuxedo ATMI/WS DLL は、付加された各アプリケーションの環境コピーを保持します。この関係付けられた環境およびコンテキスト情報は、tpterm() が Windows アプリケーションから呼び出されると無効になります。環境変数の値は、アプリケーション・プログラムが tpterm() を呼び出した後で変更できます。

DOS、Windows、および OS/2 環境では、大文字の変数名を使用することをお勧めします(tuxreadenv() はすべての環境変数名を大文字に変換します)。

関連項目