utoa() - ストリングへの unsigned int の変換

標準

標準/拡張機能	C/C++	依存項目
z/OS® UNIX	両方	z/OS V1R5

形式

#define _OPEN_SYS_ITOA_EXT
#include <stdlib.h>

char * utoa(unsigned int n, char * buffer, int radix);

機能説明

utoa() 関数は符号なし整数 n を文字ストリングに変換します。このストリングは、渡されたバッファーに置かれます。このバッファーは、出力を入れられるだけの十分な大きさが必要です。基数値は、OCTAL、DECIMAL、または HEX が可能です。基数が DECIMAL の場合、utoa() は以下のステートメントと同じ結果を生成します。

(void) sprintf(buffer, "%u", n);

「buffer」は、戻り文字ストリングを示します。基数が OCTAL の場合、utoa() は符号なし整数 n を 8 進定数にフォーマット設定します。基数が HEX の場合、utoa() は符号なし整数 n を 16 進定数にフォーマット設定します。 16 進値は、必要に応じて、小文字の abcdef を含みます。

戻り値

ストリング・ポインター (バッファーと同じ) が戻されます。無効な基数引数が渡されると、関数は NULL を戻し、errno に EINVAL を設定します。

移植性に関する考慮事項

これは非標準関数です。提供されるプロトタイプは他のプラットフォームのコンパイラーで一般的に使用されていますが、この関数がすべてのプラットフォームであらゆる場合において同じ動作をするという保証はありません。この関数は他のプラットフォームからアプリケーションを移植する場合には役立ちますが、新規アプリケーションを作成するときには、最大の移植性を確保するために、この関数の使用は避けるべきです。

例

CELEBU10

/* CELEBU10

   This example reads an unsigned int and formats it to decimal,
   octal, hexadecimal constants converted to a character string.

*/

#define _OPEN_SYS_ITOA_EXT
#include <stdio.h>
#include <stdlib.h>

int main ()
{
   unsigned int i;
   char buffer [sizeof(unsigned int)*8+1];
   printf ("Enter a number: ");
   if (scanf ("%u",&i) == 1) {
      utoa (i,buffer,DECIMAL);
      printf ("decimal: %s¥n",buffer);
      utoa (i,buffer,HEX);
      printf ("hexadecimal: %s¥n",buffer);
      utoa (i,buffer,OCTAL);
      printf ("octal: %s¥n",buffer);
   }
   return 0;
}

出力

入力が 1234 の場合、出力は次のようになります。

decimal: 1234
hexadecimal: 4d2
octal: 2322

utoa() - ストリングへの unsigned int の変換

標準

形式

機能説明

戻り値

移植性に関する考慮事項

例

関連情報