本文共 1665 字，大约阅读时间需要 5 分钟。

CStringArray 类详细文档

01. 目录

1.1. 类结构

1.2. 内部机制

1.3. 与 CObject 的关系

1.4. 主要成员函数

02. CStringArray 概述

AsStringArray 类专门用于管理多个 CString 对象的数组，支持动态大小的扩展。与 CString 类有所不同，AsStringArray 允许集中管理多个字符串，具有可扩展的内存分配机制。

其核心特点：

03. 使用须知

3.1. 类继承关系

AsStringArray 类直接继承自 CObject，其成员函数与 CObject 的函数类似。

3.2. 必要包含的头文件

为了使用 AsStringArray，需要包含以下头文件：

#include 
   
    #include 
    
   

3.3. 注意事项

04. 创建与成员函数讲解

4.1. 已知成员函数

以下是 AsStringArray 的主要成员函数及其作用：

基本操作

• Constructor：无参数构造空数组。
• Add()： Append to：将一个元素添加到数组末尾，必要时扩展数组大小。
• Append()：将另一个数组追加，扩展数组大小。
• Copy()：复制另一个数组到当前数组，扩展大小如有必要。
• ElementAt()：返回当前索引处的字符串引用。
• FreeExtra()：释放当前上限以上的未使用内存。
• GetCount()：获取数组中的元素数。
• GetSize()：与 GetCount() 效果相同。
• GetUpperBound()：返回数组的最大有效索引值。
• InsertAt()：在指定索引处插入元素或其他数组的所有内容。
• RemoveAt()：移除指定索引处的元素。
• RemoveAll()：清空数组。
• SetSize()：设置数组的大小并分配内存。
• SetAt()：设置指定索引的值（数组大小不变）。
• SetAtGrow()：设置指定索引的值，可能会扩展数组大小。
• GetData()：允许直接访问数组中的内容。
• IsEmpty()：判断数组是否为空。

语言示例

// 构造空数组示例CStringArray strArray;// 添加示例strArray.Add(_T("Hello"));  // 添加单个字符串CStringArray strArrayList;  // 创建新数组strArrayList.Add(_T("Hello"), _T("World"));  // 添加多个元素// 替换示例strArray.SetAt(0, _T("Hi"));  // 用new[]的内存替换// 插入示例strArray.SetSize(2);  // 预先分配内存strArray.InsertAt(0, _T("Bye"));  // 在索引0插入元素// 打印示例for (int i = 0; i < strArray.GetCount(); ++i) {    cout << strArray.GetAt(i).GetStr() << endl;}

05. 小结

经过上述介绍，可以看出 AsStringArray 是一个功能强大的工具类，适用于处理多个 CString 对象的高效管理。其操作方法与 CObject 类似，便于调用。如需进一步了解，可以参考 Microsoft 官方文档或相关开发工具手册。

转载地址：http://hsllz.baihongyu.com/