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

前へ 次へ 目次 索引

scanf

標準入力 ( stdin) からの書式付き入力を実行し，書式指定に従って解釈します。書式指定子については『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 2 章を参照してください。

形式

#include <stdio.h>

int scanf (const char *format_spec, ...);

引数

format_spec

書式指定を含んでいる文字列へのポインタ。書式指定は，入力からそのまま取得され，指定された入力ソースに変換されてメモリに格納される文字から構成されています。変換文字のリストについては，『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 2 章を参照してください。

...

結果として得られる型が，書式指定で与えられた変換指定に対応するオブジェクトへのポインタであるオプションの式。

変換指定が与えられなかった場合，これらの入力ポインタは省略することができます。そうでない場合は，関数呼び出しは変換指定の数以上の入力ポインタを持っていなくてはならず，変換指定は入力ポインタの型と一致していなくてはなりません。

変換指定は，左から右の順序で入力ソースと照合されます。余分な入力ポインタがある場合には，無視されます。

戻り値

x 照合に成功し，代入が行われた入力項目の数。
EOF 変換に成功する前に読み込みエラーが発生したことを示します。関数は errno を設定します。この関数が設定する errno 値のリストについては， fscanf を参照してください。

[w]scanw

ウィンドウ上で scanfを実行します。 scanw関数は stdscrウィンドウに作用します。

形式

#include <curses.h>

int scanw (char *format_spec, ...);

int wscanw (WINDOW *win, char *format_spec, ...);

引数

win

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

format_spec

書式指定文字列へのポインタ。

...

結果として得られる型が，書式指定で与えられた変換指定に対応するオブジェクトへのポインタであるオプションの式。変換指定が与えられなかった場合，これらの入力ポインタは省略することができます。

そうでない場合は，関数呼び出しは変換指定の数以上の入力ポインタを持っていなくてはならず，変換指定は入力ポインタの型と一致していなくてはなりません。

変換指定は，左から右の順序で入力ソースと照合されます。余分な入力ポインタがある場合には，無視されます。

説明

書式指定 (format_spec) とその他の引数は， scanf関数で使用されるものと同じです。

scanwおよび wscanw関数は，ターミナル・スクリーンからテキスト行を受け付け，書式を設定し，返します。詳細については， scrollokおよび scanf関数を参照してください。

戻り値

OK 成功を示します。
ERR 関数がスクリーンに不正なスクロールを引き起こすか，スキャンが失敗したことを示します。

scroll

ウィンドウ上のすべての行を 1 行上に移動します。一番上の行はウィンドウからスクロールして消え，一番下の行は空白になります。

形式

#include <curses.h>

int scroll (WINDOW *win);

引数

win

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

戻り値

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

scrollok

指定されたウィンドウのスクロール・フラグを設定します。

形式

#include <curses.h>

scrollok (WINDOW *win, bool boolf);

引数

win

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

boolf

論理型の TRUE または FALSE 値。 boolf が FALSE の場合，スクロールは許可されません。これはデフォルトの設定です。bool 型は， <curses.h>ヘッダ・ファイルに次のように定義されています。 


#define bool int

seed48

48 ビットの乱数ジェネレータを初期化します。

形式

#include <stdlib.h>

unsigned short *seed48 (unsigned short seed_16v[3]);

引数

seed_16v

48 ビットのシード値を構成する， 3 つの unsigned short intの配列。

説明

seed48関数は乱数ジェネレータを初期化します。この関数は，プログラム内で drand48， lrand48，または mrand48関数を呼び出す前に使用することができます ( これは推奨はされませんが， drand48， lrand48，または mrand48関数が，初期化関数を呼び出すことなく呼び出された場合には，定数のデフォルト・イニシアライザ値が自動的に提供されます)。

seed48関数は，次の線形合同式に従って， 48 ビットの整数値 Xi のシーケンスを生成します。 


       Xn+1 = (aXn+c)mod m        n > 0

引数 m は 248 に等しいので， 48 ビット整数算術演算が実行されます。 lcong48関数を呼び出さなかった場合，乗数値 a と加算される値 c は次のようになります。 


      a = 5DEECE66D16 = 2736731631558
      c = B16 = 138

初期化関数 seed48は，次の処理を行います。

返されたポインタを使用して，任意の時点で擬似乱数シーケンスを再開することができます。このポインタを使って，前の Xi 値を一時的配列にコピーしてください。元のシーケンスが中断した場所から再開するには，この配列へのポインタを指定して seed48を呼び出します。

drand48， lrand48，および mrand48も参照してください。

戻り値

x 48 ビットの内部バッファへのポインタ。

seekdir

ディレクトリ・ストリームの位置を設定します。

形式

#include <dirent.h>

void seekdir (DIR *dir_pointer, long int location);

引数

dir_pointer

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

location

ディレクトリの先頭を基準としたエントリの番号。

説明

seekdir関数は， dir_pointer によって指定されたディレクトリ・ストリーム上の次の readdir操作の位置を， location によって指定された位置に設定します。 location の値は，以前の telldir の呼び出しから返されたものです。

location の値が以前の telldir関数の呼び出しから返されたものでない場合，またはこのディレクトリ・ストリームに対する rewinddir関数の呼び出しが途中で行われていた場合の効果は定められていません。

<dirent.h>ヘッダ・ファイルに定義されている DIR型は，ディレクトリ・ストリームを表します。ディレクトリ・ストリームとは，特定のディレクトリ内のすべてのディレクトリ・エントリの順序付きのシーケンスです。ディレクトリ・エントリはファイルを表します。 readdir関数の操作とは非同期的に，ディレクトリのファイルの削除や追加を行うことができます。

readdir， rewinddir，および telldirを参照してください。

[w]setattr

ウィンドウ内でビデオ表示属性 attr を有効にします。 setattr関数は stdscrウィンドウに作用します。

形式

#include <curses.h>

int setattr (int attr);

int wsetattr (WINDOW *win, int attr);

引数

win

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

attr

点滅，ボールド，反転ビデオ，および下線のビデオ表示属性。それぞれ定義済み定数 _BLINK，_BOLD，_REVERSE，および _UNDERLINE によって表現されます。次のようにビット論理和演算子 (|) で区切ることで，複数の属性を設定することができます。 


setattr(_BLINK | _UNDERLINE);

説明

setattrおよび wsetattr関数は HP C for OpenVMS システムに固有のもので，移植性はありません。

戻り値

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

setbuf

入力ファイルまたは出力ファイルに新しいバッファを関連付けます。バッファリングの動作を変更することもあります。

形式

#include <stdio.h>

void setbuf (FILE *file_ptr, char *buffer);

引数

file_ptr

ファイル・ポインタ。

buffer

文字配列へのポインタ，または NULL ポインタ。

説明

setbuf関数は，指定されたファイルがオープンされた後，ただし I/O 操作が実行される前に使用することができます。

buffer が NULL ポインタである場合，この呼び出しは，同じ file_ptr，NULL の buffer ポインタ， _IONBF のバッファリング・タイプ (バッファリングなし)，およびバッファ・サイズ 0 を指定する setvbuf呼び出しと等価です。

buffer が NULL ポインタでない場合，この呼び出しは，同じ file_ptr，同じ buffer ポインタ， _IOFBF のバッファリング・タイプ，および値 BUFSIZ ( <stdio.h>に定義) で指定されるバッファ・サイズを指定する setvbuf呼び出しと等価です。したがって， setbufの呼び出しで使用する buffer 引数を割り当てるときには BUFSIZ を使用するようにします。次に例を示します。 


#include <stdio.h> 
   .
   .
   .
char my_buf[BUFSIZ]; 
   .
   .
   .
setbuf(stdout, my_buf); 
   .
   .
   .

ユーザ・プログラムは，ストリームに対して I/O が実行された後には， buffer の内容に依存してはなりません。 HP C RTL は，どの I/O 操作についても， buffer を使用する場合と使用しない場合があります。

もともと setbuf関数は，古いバージョンの UNIX のシステム・デフォルト・バッファの代わりに，プログラマが大きなバッファを割り当てられるようにすることを目的としていました。今日の C のインプリメンテーションでは，デフォルト・バッファ・サイズが大きいため，この関数はほとんどのケースでは不要です。 setbuf関数は，ANSI C 標準では，古いプログラムとの互換性のために残されています。新規のプログラムでは，代わりに setvbufを使用するようにしてください。この関数では，プログラマはコンパイル時ではなく実行時にバッファ・サイズをバインドすることができますし，テスト可能な結果値が返されます。

setenv

現在の環境リストの name で指定された環境変数を挿入または再設定します。

形式

#include <stdlib.h>

int setenv (const char *name, const char *value, int overwrite);

引数

name

環境変数リストの中の変数名。

value

環境変数の値。

overwrite

環境変数が存在していた場合，それを再設定するかどうかを示す 0 または 1 の値。

説明

setenv関数は，現在の環境リストの環境変数 name を挿入または再設定します。リストに変数 name が存在しなければ， value 引数を使って挿入されます。変数が存在していれば，overwrite 引数がテストされます。 overwrite 引数の値に応じて，次の処理が行われます。

戻り値

0 成功を示します。
- 1 エラーを示します。 errno は ENOMEM に設定されます。環境リストを拡張するのに十分なメモリがありません。

seteuid (Alpha only)

プロセスの実効ユーザ ID を設定します。

形式

#include <unistd.h>

int seteuid (uid_t euid);

引数

euid

実効ユーザ ID として設定する値。

説明

プロセスに IMPERSONATE 特権がある場合， seteuid関数は，プロセスの実効ユーザ ID を設定します。

特権のないプロセスは，euid 引数がプロセスの実ユーザ ID，実効ユーザ ID，保存済みユーザ ID のいずれかと同じ場合にのみ，実効ユーザ ID を設定できます。

戻り値

0 成功を示します。
- 1 エラーを示します。この関数は，次のいずれかの値を errno に設定します。

  • EINVAL -- euid 引数の値が不正，またはサポートされていません。

  • EPERM -- プロセスに IMPERSONATE 特権がなく， euid が実ユーザ ID と保存済みセット・ユーザ ID のどちらとも一致しません。

setgid

POSIX ID が無効化されている場合には，プログラムの移植性のために setgidがインプリメントされており，何の機能も持ちません。成功を示す 0 を返します。

POSIX ID が有効になっている場合には， setgidはグループ ID を設定します。

形式

#include <types.h>

#include <unistd.h>

int setgid (__gid_t gid); (_DECC_V4_SOURCE)

int setgid (gid_t gid); (not _DECC_V4_SOURCE)

引数

gid

グループ ID に設定する値。

説明

setgid関数は， POSIX スタイル識別子が有効の場合でも無効の場合でも使用できます。

POSIX 形式の ID は， OpenVMS バージョン 7.3-2 およびそれ以降でサポートされています。

POSIX ID が無効化されている場合， setgid関数はプログラムの移植性のためにインプリメントされており，何の機能も持ちません。成功を示す 0 を返します。

POSIX ID が有効になっている場合には，次の処理が行われます。

POSIX 形式の ID を有効または無効にする方法については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 1.7 節を参照してください。

戻り値

0 成功を示します。
- 1 エラーを示します。関数は errno を以下のいずれかの値に設定します。

  • EINVAL -- gid 引数の値が無効で，インプリメンテーションによってサポートされていない。

  • EPERM -- プロセスは適切な特権を持っておらず， gid は実グループ ID または保存済みセット・グループ ID と一致しない。

前へ 次へ 目次 索引