XCSDD/docs/api/containers/string/reserve-resize.md

String::Reserve / Resize

void Reserve(SizeType capacity);
void Resize(SizeType newSize);
void Resize(SizeType newSize, char fillChar);

管理字符串的内存和大小。

参数：

• capacity - 要预留的最小容量
• newSize - 新的字符串长度
• fillChar - 当扩展字符串时用于填充新增位置的字符，默认为 '\0'

返回： 无

复杂度：

• Reserve：最坏 O(n)，仅在需要扩展容量时复制数据
• Resize：O(n)，当 newSize > Length 时可能需要扩展

示例：

#include "XCEngine/Containers/String.h"
#include <iostream>

int main() {
    XCEngine::Containers::String s("Hi");

    // Reserve - 预分配内存
    s.Reserve(100);
    std::cout << "After Reserve(100), Capacity: " << s.Capacity() << std::endl;
    // 输出: After Reserve(100), Capacity: 100

    // Resize - 缩短字符串
    s.Resize(1);
    std::cout << "After Resize(1): " << s.CStr() << std::endl;  // 输出: H

    // Resize - 扩展字符串，用 'X' 填充
    s.Resize(5, 'X');
    std::cout << "After Resize(5, 'X'): " << s.CStr() << std::endl;  // 输出: HXXXX

    return 0;
}

相关文档

• String 总览 - 返回类总览
• Length / Capacity - 获取长度和容量
• Clear - 清空字符串