跳到主要内容

printf

注意

这个$函数以小写字母开头。

描述

在控制台(服务器窗口,非游戏内聊天框)输出格式化字符串。

名称描述
const format[]格式字符串
{Float, _}:...任意标签类型的可变数量参数

返回值

该函数不返回特定值。

格式说明符

标识符含义
%i整数
%d整数
%s字符串
%f浮点数
%cASCII 字符
%x十六进制数
%b二进制数
%%字面量 '%'
%q为 SQLite 转义文本(0.3.7 R2 版本新增)

占位符对应的参数值必须严格按照调用时的参数顺序排列,例如 "我今年%i岁" 中的 %i 将被替换为表示年龄的整型变量。

可在 % 和格式字母之间添加数字指定字段宽度。若参数值的实际宽度小于指定字段宽度,系统会自动用空格扩展字段。若要限制浮点数显示的小数位数,可在 %f 之间添加 .<最大位数>,例如 %.2f 表示保留两位小数。

示例

new number = 42;
printf("数值为 %d。", number); // 数值为 42。

new string[] = "简单信息";
printf("这是包含数字 %d 的 %s。", string, number); // 这是包含数字 42 的简单信息。

new character = 64;
printf("字符表示为:%c", character); // 字符表示为:@

注意事项

注意

格式字符串或其输出结果不应超过 1024 个字符。超出该长度可能导致服务器崩溃。

相关函数

  • print: 向服务器日志和控制台输出基础信息
  • format: 格式化字符串