prg_string_int64_format()

摘要

返回有符号 64 位整数的格式化字符串表示。

语法

prg_string_int64_format (num, num_before, buf_size, buf, options)
参数 类型 说明
num VosT_Int64 要格式化的数值。
num_before unsigned int 允许的最大字符数(计入千位分隔符和正负号)。必须 >= 0。
buf_size unsigned int 用于格式化字符串的区域大小。
buf char * 用于存放格式化字符串的区域。
options int 格式化选项(见 Details 小节中的 选项)。

返回类型

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。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com