diff --git a/MacroMath.md b/MacroMath.md index bace64c..4c6ca67 100644 --- a/MacroMath.md +++ b/MacroMath.md @@ -42,13 +42,32 @@ NumberToChinese ListToString - ## 文本构建池 提供`StringBuilderPool`对象池,可以使用常规的方法访问这个池,或使用`GetStrBuilder`直接获取一个StringBuilder,然后使用完毕后通过`ReleaseStrBuilder`立刻获取StringBuilder里拼接的文本,并释放这个stringBuilder。 XericLibrary里的所有需要文本拼接的地方都会用到这个成员,请严格按照池化对象操作流程使用,如果错误的使用释放的对象,可能会造成意外的错误。 +下面是用例: +``` +public string GetString() +{ + StringBuilder sb = MacroMath.GetStrBuilder(); + sb.Append("something..."); + return MacroMath.ReleaseStrBuilder(sb); +} +``` +可以看到,在对象池上释放这个构建器对象可以立刻获得里面的内容,可以省略部分内容。 + +另外还有一个文本拼接器单例用法: +``` +MacroMath.CleanString(); // 先清空,避免有污染 +MacroMath.AppendString("some"); // 拼接单个文本 +MacroMath.BuildString("thing", "..."); // 拼接多个文本 +MacroMath.GetStringAndClear(); // 返回 something... +``` +这个不是对象池,而是一个单例对象,可以随用随取。 + ## 链式语法的文本序列拼接。 提供`Join`扩展方法。用法与直接使用`string.Join()`类似。