OpenVMS
HP C ランタイム・ライブラリ・
リファレンス・マニュアル (下巻)


前へ 次へ 目次 索引



tan

ラジアンの引数の正接である double値を返します。

形式

#include <math.h>

double tan (double x);

float tanf (float x); (Alpha only)

long double tanl (long double x); (Alpha only)

double tand (double x); (Alpha only)

float tandf (float x); (Alpha only)

long double tandl (long double x); (Alpha only)


引数

x

実数として表現されたラジアン。

説明

tan関数は,ラジアン単位の x の正接を計算します。

tand関数は,度単位の x の正接を計算します。


戻り値

x 引数の正接。
HUGE_VAL x は特異点です。 (... - 3pi/2, - pi/2, pi/2...)
NaN x は NaN です。 errno は EDOM に設定されます。
0 x は ± 無限大です。 errno は EDOM に設定されます。
±HUGE_VAL オーバフローが発生しました。 errno は ERANGE に設定されます。
0 アンダフローが発生しました。 errno は ERANGE に設定されます。


tanh

引数の双曲線正接を返します。

形式

#include <math.h>

double tanh (double x);

float tanhf (float x); (Alpha only)

long double tanhl (long double x); (Alpha only)


引数

x

実数。

説明

tanh関数は,(e**x - e**( - x))/(e**x + e**( - x)) として計算される,引数の双曲線正接を返します。

戻り値

n 引数の双曲線正接。
HUGE_VAL 引数の値が大きすぎます。 errno は ERANGE に設定されます。
NaN x は NaN です。 errno は EDOM に設定されます。
0 アンダフローが発生しました。 errno は ERANGE に設定されます。


telldir

指定されたディレクトリ・ストリームに関連付けられている現在の位置を返します。ディレクトリに対する操作を実行します。

形式

#include <dirent.h>

long int telldir (DIR *dir_pointer);


引数

dir_pointer

オープン・ディレクトリの DIR構造体へのポインタ。

説明

telldir関数は,指定されたディレクトリ・ストリームに関連付けられている現在の位置を返します。

戻り値

x 現在の位置。
- 1 エラーを示します。エラーの詳しい内容は,グローバルな errno に設定されます。


tempnam

一時的ファイルの名前を作成します。

形式

#include <stdio.h>

char *tempnam (const char *directory, const char *prefix, ...);


引数

directory

ファイルを作成するディレクトリのパス名へのポインタ。

prefix

ファイル名の先頭の文字シーケンスへのポインタ。 prefix 引数は null であってもよく,一時的ファイル名の先頭の文字として使用される 5 文字までの文字列をポイントすることもできます。

...

省略可能な引数であり,1 または 0 を指定できます。 1 を指定した場合, tempnamは, OpenVMS 形式のファイル指定を返します。 0 を指定した場合, tempnamは, UNIX 形式のファイル指定を返します。 UNIX 形式のファイル指定の詳細については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.4.3 項を参照してください。

説明

tempnam関数は,一時的ファイルのためのファイル名を生成します。この関数では,ファイルを作成するディレクトリを選択することができます。

directory 引数が null であるか,適切なディレクトリのパス名でない文字列をポイントしていた場合には, < stdio.h> ヘッダ・ファイルに P_tmpdirとして定義されているパス名が使用されます。

ユーザ環境で TMPDIR環境変数を指定することで,パス名の選択をバイパスすることができます。 TMPDIR変数の値は,目的の一時的ファイル・ディレクトリのパス名です。

prefix 引数を使用して,一時的ファイル名の 5 文字までの接頭辞を指定することができます。

tempnam関数は,後に free関数の呼び出しで使用できる,生成されたパス名へのポインタを返します。

freeも参照してください。

注意

tmpnamとは対照的に, tempnamは呼び出しのたびに異なるファイル名を生成するとは限りません。 tempnamは,指定された名前のファイルが存在する場合にのみ,新しいファイル名を生成します。呼び出しのたびに一意のファイル名が必要な場合には, tempnamではなく tmpnamを使用してください。


戻り値

x 後に free 関数の呼び出しで使用できる,生成されたパス名へのポインタ。
NULL エラーが発生しました。 errno はエラーを示す値に設定されます。


time

1970 年 1 月 1 日の 00:00:00 からの (協定世界時での) 経過秒数を返します。

形式

#include <time.h>

time_t time (time_t *time_location);

関数バリアント _DECC_V4_SOURCE および _VMS_V6_SOURCE 機能テスト・マクロを定義してコンパイルすると, OpenVMS バージョン 7.0 より前の動作と等価な, time関数へのローカル時刻ベースのエントリ・ポイントが使用可能となります。

引数

time_location

NULL,または返された時刻が格納される場所へのポインタ。 time_t型は, <time.h>ヘッダ・ファイルに次のように定義されています。


typedef unsigned long int time_t; 


戻り値

x Epoch からの経過秒数
( time_t )( - 1) エラーを示します。 SYS$TIMEZONE_DIFFERENTIAL 論理名の値が間違っている場合,関数は実行に失敗し, errno は EINVAL に設定されます。


times

現在のプロセスと,その終了した子プロセスの累積時間を返します。

形式

#include <times.h>

clock_t times (struct tms *buffer); (OpenVMS V7.0 and higher)

void times (tbuffer_t *buffer); (pre OpenVMS V7.0)


引数

buffer

ターミナル・バッファへのポインタ。

説明

プロセスと子プロセスの両方の時刻について,構造体は時間をユーザ時間とシステム時間に分離します。 OpenVMS システムはシステム時間とユーザ時間を区別しないため,すべてのシステム時間は 0 として返されます。累積 CPU 時間は,10 ミリ秒単位で返されます。

子プロセスの累積時間は,C のメイン・プログラム,または VAXC$CRTL_INITあるいは DECC$CRTL_INITを呼び出すプログラムでのみ含められます。

OpenVMS バージョン 7.0 およびそれ以降のシステムでは, times関数は,過去の任意の基準時刻 ( たとえばシステムのスタートアップ時刻 ) 以降の経過時間をクロック・ティック単位で返します。この基準時刻は, times関数の呼び出しの間で変化しません。戻り値は, clock_t型の値の範囲を超えてオーバフローすることがあります。 timesは実行に失敗すると値 - 1 を返します。 HP C RTL は基準時刻としてシステムのブート時刻を使用します。


戻り値

x システムのブート時刻以降の,クロック・ティック単位での経過時間。
( clock_t )( - 1) エラーを示します。


tmpfile

更新が可能なようにオープンされた一時的ファイルを作成します。

形式

#include <stdio.h>

FILE *tmpfile (void);


説明

ファイルは,プロセスが存在している間のみ,またはファイルがクローズされるまで存在し, vforkの呼び出しの前後で保持されます。

戻り値

x ファイル・ポインタのアドレス ( <stdio.h> ヘッダ・ファイルに定義)。
NULL エラーを示します。


tmpnam

一時的ファイルに安全に使用できるファイル名を生成します。

形式

#include <stdio.h>

char *tmpnam (char *name);

関数バリアント tmpnam関数は,それぞれ 32 ビットと 64 ビットのポインタ・サイズで使用するための _tmpnam32_tmpnam64という名前のバリアントを持っています。ポインタ・サイズ固有の関数の使用方法については,『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.10 節を参照してください。

引数

name

関数またはマクロのファイル名引数の代わりとして使用する名前を含んでいる文字列。後に null 引数を指定して tmpnamを呼び出すと,関数は現在の名前を上書きします。

戻り値

x name 引数が NULL ポインタ値 NULL である場合, tmpnam は内部記憶領域のアドレスを返します。 name が NULL でない場合には,長さ L_tmpnam ( <stdio.h> ヘッダ・ファイルに定義) の領域のアドレスと見なされます。この場合, tmpnam は結果として name 引数を返します。


toascii

8 ビット ASCII 文字の引数を 7 ビット ASCII 文字に変換します。

形式

#include <ctype.h>

int toascii (char character);


引数

character

char型のオブジェクト。

戻り値

x 7 ビット ASCII 文字。


tolower

文字を小文字に変換します。

形式

#include <ctype.h>

int tolower (int character);


引数

character

unsigned charとして表現可能な int型のオブジェクト,または EOF の値。これ以外の値が指定された場合の動作は未定義です。

説明

引数が大文字を表しており,プログラム・ロケール・カテゴリ LC_CTYPE の文字型情報の定義に従って,それに対応する小文字が存在する場合には,対応する小文字が返されます。

引数が大文字でない場合には,その文字が変更なしに返されます。


戻り値

x 引数に対応する小文字。引数が大文字でない場合には,その引数が変更なしに返されます。


_tolower

大文字を小文字に変換します。

形式

#include <ctype.h>

int _tolower (int character);


引数

character

この引数は大文字でなくてはなりません。

説明

_tolowerマクロは,引数が大文字でなくてはならない (小文字や EOF であってはならない) ことを除けば, tolower関数と等価です。

_tolowerマクロでは,副作用を含んでいる引数を使用してはなりません。たとえば,次の例は期待される結果を返しません。


d = _tolower (c++); 


戻り値

x 引数に対応する小文字。


touchwin

ターミナル・スクリーンに,指定されたウィンドウの最新の編集済みバージョンを表示します。

形式

#include <curses.h>

int touchwin (WINDOW *win);


引数

win

ウィンドウへのポインタ。

説明

touchwin関数は,通常はオーバラップするウィンドウを再表示する目的にのみ使用されます。

戻り値

OK 成功を示します。
ERR エラーを示します。


toupper

文字を大文字に変換します。

形式

#include <ctype.h>

int toupper (int character);


引数

character

unsigned charとして表現可能な int型のオブジェクト,または EOF の値。これ以外の値が指定された場合の動作は未定義です。

説明

引数が小文字を表しており,プログラム・ロケール・カテゴリ LC_CTYPE の文字型情報の定義に従って,それに対応する大文字が存在する場合には,対応する大文字が返されます。

引数が小文字でない場合には,その文字が変更なしに返されます。


戻り値

x 引数に対応する大文字。引数が小文字でない場合には,その引数が変更なしに返されます。


_toupper

小文字を大文字に変換します。

形式

#include <ctype.h>

int _toupper (int character);


引数

character

この引数は小文字でなくてはなりません。

説明

_toupperマクロは,引数が小文字でなくてはならない (大文字や EOF であってはならない) ことを除けば, toupper関数と等価です。

_toupperマクロでは,副作用を含んでいる引数を使用してはなりません。たとえば,次の例は期待される結果を返しません。


d = _toupper (c++); 


戻り値

x 引数に対応する大文字。


towctrans

指定されたマッピング記述子に従って, 1 つのワイド文字を別のワイド文字にマップします。

形式

#include <wctype.h>

wint_t towctrans (wint_t wc, wctrans_t desc);


引数

wc

マップするワイド文字。

desc

wctrans関数の呼び出しを通して取得されるマッピングの記述。

説明

towctrans関数は, descによって記述されたマッピングを使用して, wc で指定されたワイド文字をマップします。

LC_CTYPEカテゴリの現在の設定は, desc の値を返した wctrans関数の呼び出しの際の設定と同じでなくてはなりません。


戻り値

x ワイド文字 wcdesc によって記述されたマッピング内に存在する場合には,そのマップされた値。存在しない場合には, wc の値が返されます。


前へ 次へ 目次 索引