API StringBuffer

StringBuffer

增量字符串构建

Incremental string construction

脚本 API 目录

概述

StringBuffer 适合在循环中拼接大量文本。完成后使用 toString 保留缓冲区，或使用 stringAndRelease 获取文本并确定性释放。释放后不要继续使用同一实例。

StringBuffer is for building substantial text in loops. Use toString to retain the buffer, or stringAndRelease to get text and release it deterministically. Do not continue using an instance after release.

new StringBuffer([initialValue])

Parameters:

• initialValue
  可选初始文本。

  Optional initial text.

Returns

新缓冲区。

A new buffer.

var buffer = new StringBuffer("Hello");
return buffer.toString();

append(...values)

Parameters:

• values
  一个或多个待追加值。

  One or more values to append.

Returns

null。

null.

var buffer = new StringBuffer();
buffer.append("A", 1);
return buffer.toString(); // A1

appendLine(...values)

Parameters:

• values
  一个或多个待追加值。

  One or more values to append.

Returns

null，并追加换行。

null, after adding a line break.

var buffer = new StringBuffer();
buffer.appendLine("first");
return buffer.toString();

insert(index, value)

Parameters:

• index
  插入位置。

  Insertion index.

• value
  待插入字符串。

  String to insert.

Returns

null。

null.

var buffer = new StringBuffer("ac");
buffer.insert(1, "b");
return buffer.toString(); // abc

clear()

Parameters:

• 无。

  None.

Returns

null。

null.

var buffer = new StringBuffer("old");
buffer.clear();
return buffer.toString(); // ""

toString()

Parameters:

• 无。

  None.

Returns

当前文本，不释放缓冲区。

Current text without releasing the buffer.

var buffer = new StringBuffer("value");
return buffer.toString();

release()

Parameters:

• 无。

  None.

Returns

null。

null.

副作用

释放内部资源。

Releases internal resources.

var buffer = new StringBuffer("temporary");
buffer.release();
return 0;

stringAndRelease()

Parameters:

• 无。

  None.

Returns

当前文本，然后释放缓冲区。

Current text, then releases the buffer.

var buffer = new StringBuffer("done");
var text = buffer.stringAndRelease();
return text;