名称
ltostr(), ltostr_r(), ultostr(), ultostr_r(), ltoa(), ltoa_r(),
ultoa(), ultoa_r() ― long 整数の文字列への変換
構文
#include <stdlib.h>
char *ltostr(long n, int base);
char *ultostr(unsigned long n, int base);
char *ltoa(long n);
char *ultoa(unsigned long n);
廃止インタフェース
int ltostr_r(long n, int base, char *buffer, int
buflen);
int ultostr_r(unsigned long n, int base, char *buffer,
int buflen);
int ltoa_r(long n, char *buffer, int buflen);
int ultoa_r(unsigned long n, char *buffer, int buflen);
説明
| ltostr() | | 符号付きの long 整数を、対応する文字列表現に指定した基数で変換します。
引き数 base は、2 から 36 まで (両端を含む) でなければなりません。 |
| ultostr() | | 符号なし long 整数を、対応する文字列表現に指定した基数で変換します。
引き数 base は、2 から 36 まで (両端を含む) でなければなりません。 |
| ltoa() | | 符号付きの long 整数を、対応する 10 進数の文字列表現に変換し、結果へのポインターを返します。 |
| ultoa() | | 符号なし long 整数を、対応する 10 進数の文字列表現に変換し、結果へのポインターを返します。 |
単純な変換を行うには、これらの関数は sprintf() printf(3S) 参照) よりも小さく、高速です。
廃止インタフェース
long 整数を文字列へ変換する ltostr_r(), ultostr_r(), ltoa_r(), ultoa_r()
エラー
base の値が 2 から 36 までの間にない場合、 ltostr() および ultostr() は
NULL を返し、外部変数 errno に ERANGE を設定します。
警告
ltostr(), ultostr(), ltoa() および ultoa() の戻り値は、同じスレッドからの次回のこれらの関数呼び出しによって内容が上書きされるデータを指しています。
ltostr_r(), ultostr_r(), ltoa_r() および ultoa_r() インタフェースは廃止され、現在では既存の
DCE アプリケーションとの互換性を保つためにだけサポートされています。
新しいマルチスレッドアプリケーションでは、 ltostr(), ultostr(), ltoa() および ultoa() を使用してください。
著者
ltostr(), ultostr(), ltoa(),
および ultoa() は、HP で開発されました。
参照
strtol(3C), printf(3S), thread_safety(5)