• ホーム
• プログラミング

ANSIライブラリ関数の移植性

C言語の標準ライブラリ関数（ANSIライブラリ関数）は，標準Cをサポートする環境でライブラリ関数宣言および型やマクロの定義としてユーザに提供されている．ANSI C標準ではこれらのライブラリ関数は厳密に定義されていて，C言語の存在する任意のシステム上で互換性を持つ．したがって，標準ライブラリ関数で与えられる機能のみを使っているプログラムは，基本的には変更なしに1つのシステムから他のシステムへ移すことができる．

しかし，標準ライブラリ関数の実装に関するシステム依存部分として，次のような項目がある．

• 処理系依存関数
  ライブラリ関数の中で処理系に依存した関数が存在する．シグナル操作関数，プログラムの終了等の環境との通信に関する関数などは実装依存であり，これらの関数の機能の詳細は処理系により異なる可能性がある．
• システム資源に関する制約値
  同時にオープンできるファイル数などシステム資源に関する制約値があり，この制約値を越えた場合の動作は一般に実装依存である．
• 異常処理の扱い
  ライブラリ関数が正常処理ができないような状態のときに呼び出された場合，その動作は実装依存あるい未定義と規定されているものがある． また，エラー発生時に設定されるエラー番号の値なども実装依存である．

移植性を重視するプログラムでは，これらの実装依存部分に注意してコーディングする必要がある．

標準ライブラリ関数を使ってプログラムを作成する場合に移植上注意すべき事項をまとめる．

実装依存項目

• ストリーム
  以下に示すストリームに関する扱いは実装依存である．したがって，その扱いに関して何らかの仮定を行なったコーディングをしてはいけない．
  • テキストストリームの最後の行に，行の終端を示す改行文字が必要か否か．
  • テキストストリームの改行文字の直前に書かれた空白文字が読み込まれるときに存在するか否か．
  • バイナリストリームの終端に任意個のヌル文字が追加されるか否か．
  また，テキストストリームは終端の改行文字を含み少なくとも1行当たり254文字までが保証されており，それ以上存在し得るか否かは実装依存である．したがって，テキストストリームを扱う場合，1行は最大254文字までとすべきである．
• 文字セット
  文字セット（英数文字，空白文字，制御文字，印字文字など）の定義は，実装依存である．したがって，ライブラリとして提供されている文字操作関数も文字セットに依存している．
  処理系間で異なる文字を扱うような場合には，移植に注意が必要である．
• ファイル
  以下に示すファイルの扱いに関する事項は実装依存である．したがって，その扱いに関して何らかの仮定を行なったコーディングをしてはいけない．
  • ファイルを追加モードでオープンした場合，ファイル位置標識がファイルの先頭にあるかファイルの終りにあるか．
  • テキストストリームへの書き込みによって，そのファイルのファイル位置標識以降が切り捨てられるか否か．
  • ファイルのバッファリングの特性（完全バッファリング，行バッファリング，バッファリングなし）のサポートの有無
  • 0バイトのファイルが存在するか．
  • 同一のファイルを複数回オープンできるか．
  • 文字列としてファイル名を指定する方法．
• エラー番号
  エラー番号（errno）は，ライブラリ関数の異常終了原因を示す実装に依存した値（正の整数）であり，ライブラリが提供するerrno.hをインクルードすることにより参照可能となる． エラー番号は，プログラム開始時に0に初期化されるが，ライブラリ関数によって値が変更された後，明示的に0に設定されない限り0になることはない．したがって，エラー番号の値によりエラーの種類を検査するプログラムは，ライブラリ関数の呼出し前にエラー番号の値を0に設定し，次のライブラリ関数の呼出し前にその値を検査しなければならない．
  エラー番号の値は，エラーの種類をメッセージ等に出力するために利用し，プログラムの論理に値そのものを使ってはならない．
• 実装依存定数
  ライブラリ関数の実装に依存した定数が定義されている．移植性を考慮するプログラムはこれらの定数の値を意識したコーディングを行なう必要がある． すなわち，各プログラムではこれらの定数を越えないようにチェックする他に，移植先システムにおけるライブラリ関数の対応する定数値をも越えないようにする必要がある．
  • FOPEN_MAX
    同時にオープンすることができるファイル数
  • FILENAME_MAX
    オープンを保証されているファイル名の最大長
  • TMP_MAX
    tmpnam関数による生成が保証されているファイルの最少数
  • L_tmpnam
    tmpnam関数により生成される一時ファイル名の長さ
• 処理系依存の制限値
  処理系の実装に依存した次の制限値が定義されている． これらの処理系依存の制限値に依存したコーディングは行なわないようにする．
  整数型のサイズを表す以下の定数が定義されている．

  CHAR_BIT	：	charのビット数
  CHAR_MAX	：	charの最大値
  CHAR_MIN	：	charの最小値
  INT_MAX	：	intの最大値
  INT_MIN	：	intの最小値
  LONG_MAX	：	longの最大値
  LONG_MIN	：	longの最小値
  SCHAR_MAX	：	signed charの最大値
  SCHAR_MIN	：	signed charの最小値
  SHRT_MAX	：	shortの最大値
  SHRT_MIN	：	shortの最小値
  UCHAR_MAX	：	unsigned charの最大値
  UINT_MAX	：	unsigned intの最大値
  ULONG_MAX	：	unsigned longの最大値
  USHRT_MAX	：	unsigned shortの最大値

  浮動小数点演算に関係する以下の定数が定義されている．
  

  FLT_RADIX	：	指数表現の基数
  FLT_ROUNDS	：	加算に対する浮動小数点の丸めモード
  FLT_DIG	：	精度の10進桁数
  FLT_EPSILON	：	1.0 + x != 1.0であるような最小の数x
  FLT_MANT_DIG	：	仮数部における基数FLT_RADIXの桁数
  FLT_MAX	：	浮動小数点数の最大値
  FLT_MAX_EXP	：	FLT_RADIXn - 1が表現できるようなnの最大値
  FLT_MIN	：	正規化浮動小数点数の最小値
  FLT_MIN_EXP	：	10nが正規化された数であるようなnの最少値
  DBL_DIG	：	精度の10進桁数
  DBL_EPSILON	：	1.0 + x != 1.0であるような最小の数x
  DBL_MANT_DIG	：	仮数部における基数FLT_RADIXの桁数
  DBL_MAX	：	double浮動小数点数の最大値
  DBL_MAX_EXP	：	FLT_RADIXn - 1が表現できるようなnの最大値
  DBL_MIN	：	正規化double浮動小数点数の最小値
  DBL_MIN_EXP	：	10nが正規化された数であるようなnの最少値

• マクロ定数
  ライブラリ関数の実行に関連した以下のマクロ定数がANSIライブラリ仕様では 定義されている． これらのマクロ定数をプログラム内で使用している場合には，移植先の処理系 でも規定どおりに定義されていることを確認する必要がある．

  EDOM	：	領域エラーを表すerrnoの値
  ERANGE	：	範囲エラーを表すerrnoの値
  NULL	：	ヌルポインタ
  _IOFBF	：	setvbuf関数用のパラメータ（完全バッファ）
  _IOLBF	：	setvbuf関数用のパラメータ（行バッファ）
  _IONBF	：	setvbuf関数用のパラメータ（非バッファリング）
  BUFSIZ	：	setbuf関数用のバッファサイズ
  EOF	：	ファイルの終端
  SEEK_SET	：	fseek関数用のパラメータ(0)
  SEEK_CUR	：	fseek関数用のパラメータ(1)
  SEEK_END	：	fseek関数用のパラメータ(2)
  EXIT_SUCCESS	：	exit関数用の終了ステータス
  EXIT_FAILURE	：	exit関数用の終了ステータス
  RAND_MAX	：	rand関数の返却する最大値
  CLOCKS_PER_SEC	：	clcok関数の戻り値の補性用数値

• 定義済み識別子
  次の識別子はあらかじめ定義されており，展開されたとき特別の情報を与えるものである．これらの識別子は未定義にしたり再定義したりしてはいけない．

  __LINE__	：	現在の行番号を表す10進定数
  __FILE__	：	コンパイル中のファイル名を表す文字列リテラル
  __DATA__	：	"Mmm dd yyyy"の形式のコンパイル日付けを表す文字列リテラル
  __TIME__	：	"hh:mm:ss"の形式のコンパイル時刻を表す文字列リテラル
  __STDC__	：	ANSI標準準拠の処理系では1に定義される

ライブラリ関数

移植上の問題があるライブラリ関数について，各ライブラリ関数ごとに以下の情報を記載する．

• 関数形式
  ライブラリ関数の呼び出し形式を示す．
• 機能概要
  ライブラリ関数の機能概要を説明する．
• 実装依存
  移植上問題のある実装依存機能などを説明する．
• コーディング上の注意
  移植性を考慮する場合のコーディング上の注意点を示す．

地域情報

• setlocale
  
  • 関数形式
    

        #include <locale.h>
        char *setlocale(int category, char *locale);
    

  • 機能概要
    地域の種別をlocaleにより選択する．
  • 実装依存
    指定できるcategoryおよびlocaleの値は実装依存である．
  • コーディング上の注意
    本関数に関係する処理は#ifdefなどにより前処理時に切り分けられるようにしておく．
• localeconv
  
  • 関数形式
    

        #include <locale.h>
        struct lconv *localeconv(void);
    

  • 機能概要
    各国特有の通貨や度量衡表記の情報を取得する．
  • 実装依存
    取得される情報は実装依存である．
  • コーディング上の注意
    本関数に関係する処理は#ifdefなどにより前処理時に切り分けられるようにしておく．

シグナル処理

• signal
  
  • 関数形式
    

        #include <signal.h>
        void (*signal(int sig, void (*func)(int)))(int);
    

  • 機能概要
    sigで与えられたシグナル番号のシグナルの処理の仕方を指定する．
  • 実装依存
    サポートされているシグナルの種類は次のものを除き実装依存である．

        SIGABRT, SIGFPE, SIGILL, SIGINT, SIGSEGV, SIGTERM
    

    ただし，これらのシグナルもraise関数による明示的な呼び出しによる場合を除き，実装によっては生成されないものがある． また，上記シグナルのデフォルトの動作およびプログラム起動時の状態も実装依存である．
    シグナルが発生した時，ハンドラ関数funcが指定されていればfuncの呼び出し前にそのシグナルに対する処理はSIG_DFLにリセットされるか，実装依存のシグナルのブロックが行なわれる． SIGILLの場合には，SIG_DFLにリセットされるか否かは実装依存である．
  • コーディング上の注意
    規定されている6つのシグナルについては，使用する場合明示的に以下の関数，または利用者定義のシグナルハンドラ関数で初期化する．

        signal(sig, SIG_IGN);
        signal(sig, SIG_DFL);
    

    実装依存で追加された他のシグナルの初期状態はSIG_DFLである．
    実装依存のシグナルを使う場合は，その使用目的や移植上の注意をコメントとして明記すべきである． また，本関数に関係する処理は#ifdefなどにより前処理時に切り分けられるようにしておく．

可変引数

• 可変引数リスト
  
  • 関数形式
    

        #include <stdarg.h>
        void va_start(va_list ap, lastfix);
        type va_arg(va_list ap, type);
        void va_end(va_list ap);
    

  • 機能概要
    可変個の引数リストを使用可能にする．
  • 実装依存
    
    • パラメータapを持つva_argマクロを呼び出し，そのapを他の関数の引数にする．この時，その関数内で同じパラメータapでva_argマクロを呼び出した時，呼び出し元におけるapの値は未定義である．
    • 次の引数がない場合にva_argマクロを呼び出した時の動作は未定義である．
    • 次の引数のtypeがva_argマクロで指定したtypeと異なる場合の動作は未定義である．
    • va_endマクロが対応するva_startマクロなしに呼び出された場合の動作は未定義である．
    • va_endマクロを呼び出さないでva_startマクロにより初期化された可変引数リストを持つ関数からリターンした場合の動作は未定義である．
  • コーディング上の注意
    可変引数マクロの使用に当たっては，上記の移植性で示した未定義動作を起こさないようにする．

ファイル操作

• remove
  
  • 関数形式
    

        #include <stdio.h>
        int remove(const char *filename);
    

  • 機能概要
    filenameで指定されたファイルを削除する．
  • 実装依存
    対象ファイルがオープン状態の場合の動作は実装依存である．
  • コーディング上の注意
    削除対象ファイルがオープン状態にある可能性がある場合，remove関数呼び出し前に対象ファイルの状態をチェックし，オープン状態の場合エラーメッセージを出力したり，そのファイルをクローズするなど利用目的に応じた処理を行なう．
• rename
  
  • 関数形式
    

        #include <stdio.h>
        int rename(const char *old, const char *new);
    

  • 機能概要
    oldで指定されたファイルのファイル名をnewで指定された名前に変更する．
  • 実装依存
    newで指定された名前のファイルがrename関数呼び出し時に既に存在していた場合の動作は実装依存である．
  • コーディング上の注意
    rename関数呼び出し前に，newで指定する名前のファイルが存在するか否かをチェックし，存在する場合エラーメッセージを出力したり，その名前のファイルを消去するなど利用目的に応じた処理を行なう． 既存在ファイルは消去されることを仮定してはいけない．
• tmpfile
  
  • 関数形式
    

        #include <stdio.h>
        FILE *tmpfile(void);
    

  • 機能概要
    クローズされた時，あるいはプログラムが正常に終了した時に自動的に削除される一時ファイルを生成する．
  • 実装依存
    プログラムが異常終了した場合，一時ファイルが削除されるか否かは実装依存である．
  • コーディング上の注意
    異常終了時に一時ファイルが残っては問題があるような場合，シグナルで異常をトラップし一時ファイルを削除するような処理を実装する．
• tmpnam
  
  • 関数形式
    

        #include <stdio.h>
        char *tmpnam(char *s);
    

  • 機能概要
    既存のファイル名とは異なる文字列を生成する．
  • 実装依存
    tmpnamが呼ばれるごとに異なる名前が生成されるが，TMP_MAX回以上呼ばれた場合の動作は実装依存である（TMP_MAXの値は少なくとも25以上である）．
  • コーディング上の注意
    TMP_MAX回以上tmpnam関数を呼んでファイル名を生成しない．
    移植先のシステムが明確になっている場合，移植先のライブラリ関数のTMP_MAXの値も同時に考慮する（小さい方の値を制限値として用いる）．

ファイルアクセス関数

• fflush
  
  • 関数形式
    

        #include <stdio.h>
        int fflush(FILE *stream);
    

  • 機能概要
    出力ストリームに対して，バッファされているがまだ書き込まれていないデータを書き込む．
  • 実装依存
    入力ストリームに対する動作は未定義である．
  • コーディング上の注意
    入力ストリームに対してfflush関数を発行してはいけない．

書式付き入出力関数

• 書式付き出力
  
  • 関数形式
    

        #include <stdio.h>
        int fprintf(FILE *stream, const char *format, ...);
        int printf(const char *format, ...);
        int sprintf(char *s, const char *format, ...);
    

  • 機能概要
    指定された書式に従って変換された文字データを出力ストリームまたは文字配列に書き込む．
  • 実装依存
    
    • 1回の変換出力によって生成できる文字データの最大数は少なくとも509である．
    • sprintf関数では出力元と出力先がオーバラップしている場合の動作は未定義である．
  • コーディング上の注意
    
    • 1回の変換出力により生成する文字データは509以下とする．
    • sprintf関数では出力元と出力先がオーバラップしないようにする．
• 書式付き入力
  
  • 関数形式
    

        #include <stdio.h>
        int sscanf(const char *s, const char *format, ...);
     

  • 機能概要
    指定された書式に従ってsで指定されるデータ領域から指定された形式のデータを読み込む．
  • 実装依存
    データの入力元と出力先がオーバラップしている場合の動作は未定義である．
  • コーディング上の注意
    データの入力元と出力先がオーバラップしないようにする．

ファイル位置関数

• fflush
  
  • 関数形式
    

        #include <stdio.h>
        int fgetpos(FILE *stream, fpos_t *pos);
        int fsetpos(FILE *stream, const fpos_t *pos);
        int ftell(FILE *stream);
     

  • 機能概要
    ストリームに関するファイル位置指示子(file position indicator)の値の設定や取得を行なう．
  • 実装依存
    エラー時にerrnoに設定される値は実装依存である．
  • コーディング上の注意
    errnoの値に依存したコーディングは行なわない．

疑似乱数生成関数

• rand
  
  • 関数形式
    

        #include <stdlib.h>
        int rand(void);
    

  • 機能概要
    0からRAND_MAXの範囲の疑似乱数整数を返却する．
  • 実装依存
    RAND_MAXの値は，実装依存である．
  • コーディング上の注意
    RAND_MAXの値に依存したコーディングはしない．ただし，RAND_MAXの値は少なくとも32767である．

メモリ管理関数

• メモリの確保と解放
  
  • 関数形式
    

        #include <stdlib.h>
        void *calloc(size_t nmemb, size_t size);
        void *free(void *ptr);
        void *malloc(size_t size);
        void *realloc(void *ptr, size_t size);
    

  • 機能概要
    指定されたメモリを確保または解放する．
  • 実装依存
    
    • 要求するメモリのサイズが0の場合の動作は実装依存である．
    • 解放されたメモリの内容を参照するポインタの値は未定義である．
    • malloc, calloc, realloc関数を連続して呼び出すことによって確保されるメモリ領域の順序や連続性は不定である．
  • コーディング上の注意
    
    • メモリサイズ0でメモリの確保要求を行なわない．
    • 動的に確保したメモリ領域を解放した後に利用することは避ける． 一般には，メモリを解放した後でもその内容は変わらないことが多いが，保証されたものではない．
    • malloc, calloc, realloc関数を連続して呼び出すことによって確保されるメモリ領域について，その順序や連続性を仮定したコーディングはしない．

環境との通信

• abort
  
  • 関数形式
    

        #include <stdlib.h>
        void abort(void);
    

  • 機能概要
    SIGABRTに対するシグナルハンドラより戻らないとき，プログラムを異常終了させる．
  • 実装依存
    
    • オープン中の出力ストリームがフラッシュされるか，オープンストリームがクローズされるか，一時ファイルが削除されるかは，実装依存である．また，ホスト環境にどのような状態が戻されるかも実装依存である．
    • abort()関数実行時，SIGABRTシグナルが発生するか否かは実装依存である．
  • コーディング上の注意
    abort関数実行後の状態について，何らかの仮定を行なってはならない．
• atexit
  
  • 関数形式
    

        #include <stdlib.h>
        int atexit(void (*func)(void));
    

  • 機能概要
    プログラムが正常終了した時に呼ばれる関数funcを登録する．
  • 実装依存
    登録できる関数の数は実装依存である（少なくとも32個）．
  • コーディング上の注意
    atexitで32個以上の関数を登録しない．
• exit
  
  • 関数形式
    

        #include <stdlib.h>
        void exit(int status);
    

  • 機能概要
    プログラムを正常終了させる．
  • 実装依存
    ホスト環境に対してstatusがどう返されるかは実装依存である．
  • コーディング上の注意
    戻されるstatusの値について，0, EXIT_SUCCESS, EXIT_FAILURE以外に何らかの仮定を行なってはならない．
• getenv
  
  • 関数形式
    

        #include <stdlib.h>
        char *getenv(const char *name);
    

  • 機能概要
    ホスト環境の環境変数リストを検索し，nameで示される文字列に一致する環境変数名に対応した文字列を返却する．
  • 実装依存
    環境変数リストの内容と環境変数を変更する方法は実装依存である．
  • コーディング上の注意
    環境変数名は一般にシステムに固有であるため，移植に際しては注意が必要である．また，環境変数を変更する方法はシステムに依存しているため，移植性はない．
• system
  
  • 関数形式
    

        #include <stdlib.h>
        int system(const char *string);
    

  • 機能概要
    stringによって示される文字列をホスト環境に渡し，実装依存の方法でコマンドプロセッサによりコマンドとして実行させる．
  • 実装依存
    stringをコマンドとして実行する動作モードや方法は実装依存である．また，引数がNULLポインタでないとき，system関数の戻り値は実装依存である．
  • コーディング上の注意
    引数がNULLポインタでないとき，戻り値について何らかの仮定を行なってはならない．

整数型算術関数

• 絶対値，除算
  
  • 関数形式
    

        #include <stdlib.h>
        int abs(int x);
        div_t div(int number, int denom);
        long int labs(long int x);
        ldiv_t ldiv(long int number, long int denom);
    

  • 機能概要
    絶対値，あるいは除算を行なう．
  • 実装依存
    結果が表現できない数値になるとき，その動作は未定義である．
    2の補数を使用している処理系では，負の最小値に対する絶対値は表現できない．
  • コーディング上の注意
    abs関数では，負の最小値に対する絶対値を引数として指定しない．

文字処理関数

• memcpy
  
  • 関数形式
    

        #include <string.h>
        void *memcpy(void *dest, const void *src, size_t n);
    

  • 機能概要
    nバイトのブロックをsrcからdestに複写する．
  • 実装依存
    srcとdestがオーバラップしている場合の動作は未定義である．
  • コーディング上の注意
    srcとdestがオーバラップする可能性がある場合，memcpyの代わりにmemmoveを使用する． しかし，srcとdestがオーバラップする可能性がない場合には，memcpyを用いた方がmemmoveよりも一般に効率が良い．
• 文字列の複写
  
  • 関数形式
    

        #include <string.h>
        char *strcpy(char *dest, char *src);
        char *strncpy(char *dest, char *src, size_t n);
     

  • 機能概要
    文字列を複写する．
  • 実装依存
    
    • srcとdestがオーバラップしている場合の動作は未定義である．
    • srcまたはdestがNULLポインタの場合の動作は未規定である．
  • コーディング上の注意
    
    • srcとdestがオーバラップする可能性がある場合，srcを別のバッファに複写するなどしてオーバラップしないようにしてから関数を使用する．
    • srcまたはdestがNULLポインタにならないことを確認してから関数を呼び出す．
• 文字列の結合
  
  • 関数形式
    

        #include <string.h>
        char *strcat(char *dest, char *src);
        char *strncat(char *dest, char *src, size_t n);
     

  • 機能概要
    文字列を結合する．
  • 実装依存
    
    • srcとdestがオーバラップしている場合の動作は未定義である．
    • srcまたはdestがNULLポインタの場合の動作は未規定である．
  • コーディング上の注意
    
    • srcとdestがオーバラップする可能性がある場合，srcを別のバッファに複写するなどしてオーバラップしないようにしてから関数を使用する．
    • srcまたはdestがNULLポインタにならないことを確認してから関数を呼び出す．

数学関数

数学関数の実行時のエラーに関して，以下の項目は実装依存である．

• 引数が関数の定義されている領域の外側にあるとき領域エラーが発生する．このとき，errnoにはEDOMがセットされるが，返される値は実装依存である．
• 関数の結果がdoubleとして表現できないとき，範囲エラーが発生する．
  結果がアンダフローしたときには，関数からは0が返されるがerrnoがERANGEにセットされるかは実装依存である．結果がオーバフローしたときには，関数からは正しい符号を持つHUGE_VALが返され，errnoはERANGEにセットされる．

• fmod
  
  • 関数形式
    

        #include <math.h>
        double fmod(double x, double y);
    

  • 機能概要
    x を y で割った浮動小数点数の余り．
  • 実装依存
    y が 0 のときの結果は実装依存である．
  • コーディング上の注意
    y が 0 のときにfmod関数を呼び出さない．

複数バイト文字処理

char型では表わせられない文字セットを使用する場合，char型の代わりにwchar_t型を用いる必要がある．

複数バイト文字の変換を行なう以下の関数がある．

• 関数形式
  

      #include <stdlib.h>
      int mblen(const char *s, size_t n);
      int mbtowc(wchar_t *pwc, const char *s, size_t n);
      int wctomb(char *s, wchar_t wchar);
      size_t mbstowcs(wchar_t *pwcs, const char *s, size_t n);
      size_t wcstombs(char *s, const wchar_t *pwcs, size_t n);
  

• 機能概要
  プロセスコード文字あるいは文字列(wchar_t *型)とEUCコード文字あるいは文字列(とchar *型)の間の変換を行なう．
• 実装依存
  これらの関数の動作は環境によって異なる． また，wchar_t型の複数バイト文字列の入出力や操作を行なうには，wchar_t型を扱う処理系に依存したライブラリ関数を用いる必要がある．
• コーディング上の注意
  プログラムの先頭でsetlocale関数を明示的に呼び出し，環境に合わせた動作を行なうようにさせる． また，必要に応じてwchar_t型を扱う処理系に依存したライブラリ関数を用いる．

使用上の注意点

標準ライブラリ関数の移植性向上の観点からの使用上の注意点を示す． また，移植上の問題を持つ関数以外に，不定な動作や未定義な動作を持つ関数をまとめて示す．

• 予約識別子
  標準ライブラリ関数で使用する予約識別子は，各々のヘッダファイルに宣言されている．使用するヘッダファイル内に宣言された識別子と重複する識別子を用いないようにしなければならない．
  識別子には次のものがある．
  • マクロ名
  • 外部リンケージを持つ識別子
  • ファイルスコープを持つ識別子
  また，アンダスコアで始まる識別子はライブラリで使用するため予約されている．アンダスコアと大文字1字あるいはもう一つのアンダスコアで始まる他のすべての識別子も同様である．
• 不定な動作
  ライブラリ関数の以下に示す動作あるいは戻り値は不定(unspecified)である．
  • ungetc
    textストリームに対しては，ungetc関数が成功した後のファイル位置表示子の値は，戻された文字が全て読み出されるか破棄されるまで不定である．
  • fgetpos
    成功時にfgetpos関数によって格納される値の内容（fsetpos関数によって使用される情報を含む）の詳細は不定である．
  • ftell
    成功時にftell関数によってtextストリームに対して返却される値（ftell関数によって使用される情報を含む）は不定である．
  • bsearch
    2つの要素が等しい場合，どちらの要素が関数の戻り値として返されるかは不定である．
  • qsort
    2つの要素が等しい場合，ソートされた配列における順番は不定である．
  • time
    time関数の戻り値として返される暦時間の表現方法は不定である．
• 未定義な動作
  ライブラリ関数に対する引数が不正な値（関数の領域の外側の値，プログラムのアドレス空間の外側のポインタ，NULLポインタなど）の場合の動作は明示的に規定されていない限り未定義である． また，可変個の引数を取る関数が宣言されていない場合の動作も未定義である．
  以下のライブラリ関数の動作は未定義(undefined)である．
  • longjmp
    ネストしたシグナルハンドラ（他のシグナルの処理中に発生したシグナルに対するハンドラ処理）からlongjmpを起動したときの動作．
  • atof, atoi, atol
    atof, atoi,atolによる文字列の数への変換結果が表現できない値になるときの動作．
  • free, realloc
    freeおよびrealloc関数に対する引数のポインタが，以前にcalloc，mallocあるいはreallocのいずれかによって返却された値でないか，既にfreeまたはreallocにより解放されたメモリ領域のポインタを指している場合の動作．
    また，freeあるいはrealloc関数によって解放されたメモリの内容を参照するポインタの値．
  • fprintf, fscanf
    
    • 書式指定と引数リストの対応が一致しない場合の動作
    • 不正な変換指定が書式に現れた場合の動作

ANSI非準拠ライブラリ関数

処理系によっては，ANSI標準ライブラリ関数と機能は等価であるが，関数名やパラメータの並びの異なる関数を持つものがある．これらの関数を使用しているプログラムは，マクロ置換により対応するANSI標準ライブラリ関数に置き換えることによってANSI準拠の処理系に移植することができる．逆に，ANSI準拠の処理系から非準拠の処理系への移植の場合も同様である．

• index
  
  • 関数形式
    

        char *index(char *s, char c);
    

  • 機能概要
    文字列s内で最初に見つけた文字cを指すポインタを返却する．
  • ANSI標準ライブラリへの移植
    strchr関数と等価である．
    以下のマクロ置換を用いる．

        #define    index     strchr
    

• rindex
  
  • 関数形式
    

        char *rindex(char *s, char c);
    

  • 機能概要
    文字列s内で最後に見つけた文字cを指すポインタを返却する．
  • ANSI標準ライブラリへの移植
    strrchr関数と等価である．
    以下のマクロ置換を用いる．

        #define    rindex     strrchr
    

• bcmp
  
  • 関数形式
    

        int bcmp(char *s1, char *s2, int length);
    

  • 機能概要
    アドレスs1からのlengthバイトとアドレスs2からのlengthバイトを比較する．
  • ANSI標準ライブラリへの移植
    memcmp関数と等価である．
    以下のマクロ置換を用いる．

        #define    bcmp      memcmp
    

• bcopy
  
  • 関数形式
    

        void bcopy(char *src, char *dest, int length);
    

  • 機能概要
    文字列srcのlengthバイトをdestにコピーする．
  • ANSI標準ライブラリへの移植
    memmove関数と等価である（パラメータの順番は異なる）．memmove関数はdestを戻り値として返す．
    以下のマクロ置換を用いる．

        #define    bcopy(s1,s2,len)     memmove((s2),(s1),(len))
     

• bzero
  
  • 関数形式
    

        void bzero(char *s, int length);
    

  • 機能概要
    文字列sにlengthバイトの0を設定する．
  • ANSI標準ライブラリへの移植
    memset関数により0を設定する．memset関数は戻り値としてsの値を返す．
    以下のマクロ置換を用いる．

        #define    bzero(s,len)      memset((s),0,(len))
     

• 可変引数リスト
  
  • 関数形式
    

        void va_start(arg_ptr);
        type va_arg(arg_ptr, type);
        void va_end(arg_ptr);
    

  • 機能概要
    va_start, va_arg, va_endマクロは，関数が可変長引数をとるとき，関数への引数をアクセス可能にする方法を提供する．
  • ANSI標準ライブラリへの移植
    以下の例のようにANSI Cと前処理において切り分けるようにする．

        #if defined(__STDC__)
        #include <stdarg.h>
        #else
        #include <varargs.h>
        #endif
        .......
    
        #if defined(__STDC__)
        Msg(int err, char *fmt, ...)
        #else
        Msg(err, fmt, va_alist)
           int err;
           cahr *fmt;
           va_dcl
        #endif
        {
           va_list ap = 0;
           ........
    
        #if defined(__STDC__)
           va_start(ap, fmt);
        #else
           va_start(ap);
        #endif
           ........
        }
    

／