"numeral": Printing the numeral string utility in C
 Happy Hacking!

numeral: 整数を表す数字文字列を英語/米語の表記に変換するユーティリティ
real_numeral: 実数を表す数字文字列を英語/米語の表記に変換するユーティリティ

numeral() API は、整数を表す半角数字文字列を英語あるいは米語表記の半角英字文字列に変換します。
real_numeral() API は、実数を表す破格数字文字列を numeral() 同様にして半角英字文字列に変換します。

どちらの API も、変換できる整数の範囲は英語表記指定の場合、最大 198 桁 (負数では 199 桁) の数字列です。
米語表記指定の場合は、

-999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999

999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999

英語表記で変換後の文字列が最大になるのは、負符号 - の後に 7 を 198 桁続けた数字列で、
minus seven hundreds seventy seven duotrigintilliards seven hundreds seventy seven duotrigintillions seven hundreds seventy seven untrigintilliards seven hundreds seventy seven untrigintillions seven hundreds seventy seven trigintilliards seven hundreds seventy seven trigintillions seven hundreds seventy seven novemvigintilliards seven hundreds seventy seven novemvigintillions seven hundreds seventy seven octovigintilliards seven hundreds seventy seven octovigintillions seven hundreds seventy seven septenvigintilliards seven hundreds seventy seven septenvigintillions seven hundreds seventy seven sexvigintilliards seven hundreds seventy seven sexvigintillions seven hundreds seventy seven quinvigintilliards seven hundreds seventy seven quinvigintillions seven hundreds seventy seven quattuorvigintilliards seven hundreds seventy seven quattuorvigintillions seven hundreds seventy seven trevigintilliards seven hundreds seventy seven trevigintillions seven hundreds seventy seven duovigintilliards seven hundreds seventy seven duovigintillions seven hundreds seventy seven unvigintilliards seven hundreds seventy seven unvigintillions seven hundreds seventy seven vigintilliards seven hundreds seventy seven vigintillions seven hundreds seventy seven novemdecilliards seven hundreds seventy seven novemdecillions seven hundreds seventy seven octodecilliards seven hundreds seventy seven octodecillions seven hundreds seventy seven septendecilliards seven hundreds seventy seven septendecillions seven hundreds seventy seven sexdecilliards seven hundreds seventy seven sexdecillions seven hundreds seventy seven quindecilliards seven hundreds seventy seven quindecillions seven hundreds seventy seven quattuordecilliards seven hundreds seventy seven quattuordecillions seven hundreds seventy seven tredecilliards seven hundreds seventy seven tredecillions seven hundreds seventy seven duodecilliards seven hundreds seventy seven duodecillions seven hundreds seventy seven undecilliards seven hundreds seventy seven undecillions seven hundreds seventy seven decilliards seven hundreds seventy seven decillions seven hundreds seventy seven nonilliards seven hundreds seventy seven nonillions seven hundreds seventy seven octilliards seven hundreds seventy seven octillions seven hundreds seventy seven septilliards seven hundreds seventy seven septillions seven hundreds seventy seven sextilliards seven hundreds seventy seven sextillions seven hundreds seventy seven quintilliards seven hundreds seventy seven quintillions seven hundreds seventy seven quadrilliards seven hundreds seventy seven quadrillions seven hundreds seventy seven trilliards seven hundreds seventy seven trillions seven hundreds seventy seven billiards seven hundreds seventy seven billions seven hundreds seventy seven milliards seven hundreds seventy seven millions seven hundreds seventy seven thousands seven hundreds seventy seven
という文字列長 2913 バイトの半角英字文字列になります。
米語表記で変換後の文字列長が最長になるのは、

-7777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777

API を使用するためのヘッダは numeral.h で、API の実装は numeral.c です。API の説明は、この文書で後述しています。

テスト・プログラム numeral-test.c そして make ファイル Makefile を記述しました。テストは、

        $ make clean; make; make test

指数ごとの米語および英語表記は下表のようになります。

API の説明

1. 整数を表す半角数字文字列を米語表記の半角英字文字列に変換する numeral()
   

   int numeral(char *src
             , char *dst
             , size_t sz
             , NUMERAL_REPRE_STYLE_t style
             );
   

   src には (符合を除いて) 英語表記指定時は最大 126 桁、米語表記指定時は最大 66 桁までの半角数字文字列 (ASCII コード) を渡します。
   dst には米語表記に変換した半角英字文字列を出力します。
   出力文字列の領域には英語表記の場合は最大 2913 文字が、米語表記の場合は最大 1491 文字が出力されます。
   sz には dst の指す出力領域のサイズを指定します。
   style には英語表記を指定する場合は NUMERAL_STYLE_ENGLISH を、米語表記を指定する場合は NUMERAL_STYLE_AMERICAN を指定します。

   戻り値は以下の意味を持ちます。

   • NUMERAL_NORMAL_END (= 0) : 正常終了
   • NUMERAL_ILLEGAL_ARGS (= 1) : 不正な引数を渡された場合
   • NUMERAL_BUFFER_OVERFLOW (= 2) : 整形結果が出力先のメモリ領域サイズを超過する場合
   
   
2. 実数を表す半角数字文字列を米語表記の半角英字文字列に変換する real_numeral()
   

   int real_numeral(char *src
                  , char *dst
                  , size_t sz
                  , NUMERAL_REPRE_STYLE_t style
                  );
   

   src には実数を表す半角文字列を渡します。その文字列の整数部には、 (符合を除いて) 英語表記指定時は 126 桁、米語表記指定時は 66 桁までの桁数を許容します。
   dst には米語表記に変換した半角英字文字列を出力します。
   出力文字列の領域には英語表記の場合は最大 ((小数部桁数 + 1) * 6 + 2913) 文字が、米語表記の場合は最大 ((小数部桁数 + 1) * 6 + 1491) 文字が出力されます。
   sz には dst の指す出力領域のサイズを指定します。
   style には英語表記を指定する場合は NUMERAL_STYLE_ENGLISH を、米語表記を指定する場合は NUMERAL_STYLE_AMERICAN を指定します。

   戻り値は以下の意味を持ちます。

   • NUMERAL_NORMAL_END (= 0) : 正常終了
   • NUMERAL_ILLEGAL_ARGS (= 1) : 不正な引数を渡された場合
   • NUMERAL_BUFFER_OVERFLOW (= 2) : 整形結果が出力先のメモリ領域サイズを超過する場合