StringInit

通过指定的符号初始化字符串，并提供指定的字符串长度。

bool  StringInit(
   string&   string_var,       // string to initialize
   int       new_len=0,        // required string length after initialization
   ushort    character=0       // symbol, by which the string will be filled
   );

参数

string_var: [in][out] 需要被初始化和释放的字符串。
new_len=0: [in] 初始化后的字符串长度。如果长度=0，则释放字符串，即清空字符串缓冲区并将缓冲区地址置零。
character=0: [in] 填充字符串的符号。

返回值

成功则返回true，否则返回false。要获取错误代码，请调用GetLastError()。

注意

如果character=0且长度new_len>0，则指定长度的字符串缓冲区将被分配并填充为零。字符串长度将等于零，因为整个缓冲区已被字符串终止符填满。

示例：

void OnStart()
  {
//---
   string str;
   StringInit(str,200,0);
   Print("str = ",str,": StringBufferLen(str) = ",
         StringBufferLen(str),"  StringLen(str) = ",StringLen(str));
  }
/*  Result
str = : StringBufferLen(str) = 200   StringLen(str) = 0
*/

另请参阅

StringBufferLen(), StringLen()

最后更新于 2026-07-04

StringGetCharacter StringLen