● fixed X ユーティリティー - 関数リファレンス

FIXEDVAL値を文字列に変換した時の文字数を調べる

    int __stdcall  fixedutil_signed_num2str_cntsize(PFIXEDVAL pval ,int width ,int radix ,PFIXEDVAL pworkarea );

    int __stdcall  fixedutil_unsigned_num2str_cntsize(PFIXEDVAL pval ,int width ,int radix ,PFIXEDVAL pworkarea );

引数

引数名意味
pval文字列に変換する値が格納されている FIXEDVAL領域の先頭アドレス
widthpval の指す FIXEDVAL値の数値幅(バイト単位)
radix変換基数(2 〜 36)
pworkarea関数が使用するワークエリアを指す FIXEDVAL領域の先頭アドレス

ワークエリアに必要なサイズwidth と同じサイズ

戻り値

全体の文字数を返します(末尾ヌルを含まない)。
radix が 2 〜 36 の範囲外の場合は -1 を返します。

説明

pval の指す領域にある FIXEDVAL値を数値文字列に変換した場合の文字数を調べます。

関数fixedutil_signed_num2str_cntsize は、pval の指す値を signed として処理し、値が負の場合は負符号分もカウントします。一方、関数fixedutil_unsigned_num2str_cntsize はpval の指す値を unsigned として処理します。


引数 pval の指す領域は、width が示す数値幅以上のサイズを持っている必要があり、width は 4 の倍数である必要があります。