prg_string_uint64_format()
摘要
返回无符号 64 位整数的格式化字符串表示。
语法
prg_string_uint64_format (num, num_before, buf_size, buf, options)
| 参数 | 类型 | 说明 |
|---|---|---|
num |
VosT_uInt64 |
要格式化的数值。 |
num_before |
unsigned int |
允许的最大字符数(计入千位分隔符和正负号)。必须 >= 0。 |
buf_size |
unsigned int |
用于存放格式化字符串的区域大小。 |
buf |
char * |
用于存放格式化字符串的区域。 |
options |
int |
格式化选项(参见详情小节中的选项)。 |
返回类型
PrgT_Compcode
若 buf 或 buf_size 为 nil、数值无法格式化、数值超出 num_before,或格式化字符串大于 buf_size,返回 PrgC_Compcode_Failure;否则返回 PrgC_Compcode_Success。
头文件
prg_string_funcs.h
详情
该函数创建无符号 64 位(或 32 位)整数的格式化字符串表示。字符串按 num_before 和 options 给出的规格格式化。若 num 是符号值(如 VOSC_NA_INT64_INFINITY),则在 *buf 中返回该符号名称(此例中为 “Infinity”)。名称字符串会用空格填充(若 options 要求)至请求的字符串长度(num_before)。
选项
options 参数必须是 PRGC_STRING_FROM_INT_NONE,或以下一个或多个符号常量的 OR 组合:
PRGC_STRING_FROM_INT_NO_THOUSAND_SEPARATOR——字符串中不包含千位分隔符字符。PRGC_STRING_FROM_INT_EXCLUDE_MINUS_SIGN——负数不包含负号。PRGC_STRING_FROM_INT_INCLUDE_PLUS_SIGN——正数包含正号。PRGC_STRING_FROM_INT_PAD_LEAD_SPACES——添加前导空格,使总字符数(计入千位分隔符和正负号)等于num_before。