Cocos2d-x 字符串(String)完全学习笔记

字符串处理是游戏开发中的基础操作，无论是显示玩家信息、游戏提示还是处理配置数据，都离不开字符串。本教程将详细讲解Cocos2d-x中的字符串使用方法，包含丰富的代码示例和注释。

一、Cocos2d-x中的字符串类型

Cocos2d-x主要使用两种字符串类型：

• std::string：C++标准字符串，推荐优先使用
• cocos2d::String：引擎封装的字符串类（v3.0+后逐渐被std::string替代）

现代Cocos2d-x开发建议使用std::string，配合StringUtils工具类使用，效率更高且兼容性更好。

二、字符串的基本操作

2.1 字符串的创建与初始化

#include "cocos2d.h"
using namespace cocos2d;

// 字符串的创建与初始化
void stringCreationExamples() {
    // 1. 标准字符串创建方式
    std::string str1 = "Hello Cocos2d-x";  // 直接赋值初始化
    std::string str2("游戏开发很有趣");    // 构造函数初始化
    std::string str3(6, '!');             // 创建包含6个'!'的字符串
    
    // 2. 输出字符串内容（使用c_str()转换为C风格字符串）
    log("str1: %s", str1.c_str());  // 输出: str1: Hello Cocos2d-x
    log("str2: %s", str2.c_str());  // 输出: str2: 游戏开发很有趣
    log("str3: %s", str3.c_str());  // 输出: str3: !!!!!
    
    // 3. 获取字符串长度
    log("str1长度: %zd", str1.length());  // 输出: str1长度: 15
    log("str2长度(字节数): %zd", str2.size());  // 中文字符在UTF-8中占3字节
    
    // 4. 检查字符串是否为空
    std::string emptyStr;
    if (emptyStr.empty()) {
        log("emptyStr是空字符串");
    }
}

2.2 字符串拼接

// 字符串拼接操作
void stringConcatenationExamples() {
    std::string strA = "Hello";
    std::string strB = "World";
    
    // 方法1: 使用+运算符（最简洁）
    std::string result1 = strA + " " + strB;  // 结果: "Hello World"
    
    // 方法2: 使用append()函数
    std::string result2 = strA;
    result2.append(" ");       // 添加空格
    result2.append(strB);      // 添加strB内容
    
    // 方法3: 使用+=运算符
    std::string result3 = strA;
    result3 += " ";            // 累加空格
    result3 += strB;           // 累加strB内容
    
    // 输出结果
    log("拼接结果1: %s", result1.c_str());  // 输出: 拼接结果1: Hello World
    log("拼接结果2: %s", result2.c_str());  // 输出: 拼接结果2: Hello World
    log("拼接结果3: %s", result3.c_str());  // 输出: 拼接结果3: Hello World
}

2.3 字符串比较

// 字符串比较操作
void stringComparisonExamples() {
    std::string str1 = "apple";
    std::string str2 = "banana";
    std::string str3 = "apple";
    
    // 方法1: 使用==和!=运算符（最直观）
    if (str1 == str3) {
        log("str1 和 str3 内容相同");
    }
    
    if (str1 != str2) {
        log("str1 和 str2 内容不同");
    }
    
    // 方法2: 使用compare()函数
    // 返回值说明: 0(相等)、正数(str1 > str2)、负数(str1 < str2)
    int compareResult = str1.compare(str2);
    if (compareResult < 0) {
        log("str1 字典序小于 str2");
    }
    
    // 比较部分字符串: 比较str1从0开始的3个字符与str3从0开始的3个字符
    if (str1.compare(0, 3, str3, 0, 3) == 0) {
        log("str1 和 str3 的前3个字符相同");
    }
}

三、字符串格式化

字符串格式化用于创建包含变量值的字符串，在游戏中显示分数、等级等动态信息时特别有用。

// 字符串格式化操作
void stringFormattingExamples() {
    int score = 1250;
    float health = 89.5f;
    std::string playerName = "战神";
    
    // 推荐使用: Cocos2d-x的StringUtils::format()
    // 支持多种数据类型，使用方式类似printf
    std::string scoreText = StringUtils::format("当前得分: %d", score);
    log("%s", scoreText.c_str());  // 输出: 当前得分: 1250
    
    // 格式化多个变量
    std::string playerInfo = StringUtils::format(
        "玩家: %s, 等级: %d, 生命值: %.1f",
        playerName.c_str(),  // 字符串变量需要用c_str()转换
        15,                  // 等级
        health               // 生命值
    );
    log("%s", playerInfo.c_str());  // 输出: 玩家: 战神, 等级: 15, 生命值: 89.5
    
    // 格式化小数位数
    float pi = 3.1415926f;
    std::string piStr = StringUtils::format("π的值: %.2f", pi);  // 保留2位小数
    log("%s", piStr.c_str());  // 输出: π的值: 3.14
}

四、字符串与数值的转换

游戏开发中经常需要在字符串和数值之间进行转换，例如从配置文件读取数值，或显示玩家分数。

// 字符串与数值之间的转换
void stringConversionExamples() {
    // 1. 字符串转数值
    std::string intStr = "10086";
    int intValue = std::stoi(intStr);  // 字符串转整数
    log("字符串'%s'转整数: %d", intStr.c_str(), intValue);  // 输出: 10086
    
    std::string floatStr = "3.1415";
    float floatValue = std::stof(floatStr);  // 字符串转float
    double doubleValue = std::stod(floatStr);  // 字符串转double
    log("字符串'%s'转浮点数: %.2f", floatStr.c_str(), floatValue);  // 输出: 3.14
    
    // 2. 数值转字符串
    int level = 75;
    std::string levelStr = std::to_string(level);  // 整数转字符串
    log("整数%d转字符串: %s", level, levelStr.c_str());  // 输出: "75"
    
    // 带格式的数值转字符串（推荐使用）
    float damage = 999.9f;
    std::string damageStr = StringUtils::format("%.0f", damage);  // 格式化并转换
    log("浮点数%.1f转字符串: %s", damage, damageStr.c_str());  // 输出: "1000"
}

五、常用字符串工具方法

Cocos2d-x的StringUtils类提供了许多实用的字符串处理方法，让复杂操作变得简单。

// 字符串工具方法
void stringUtilityExamples() {
    // 1. 字符串分割（非常实用）
    std::string csvData = "战士,100,80,50";  // 类似CSV格式的数据
    std::vector<std::string> parts = StringUtils::split(csvData, ",");
    
    log("分割结果:");
    for (int i = 0; i < parts.size(); i++) {
        log("第%d部分: %s", i+1, parts[i].c_str());
    }
    // 输出:
    // 第1部分: 战士
    // 第2部分: 100
    // 第3部分: 80
    // 第4部分: 50
    
    // 2. 查找子字符串
    std::string mainStr = "Cocos2d-x是一个优秀的游戏引擎";
    size_t pos = mainStr.find("游戏");  // 查找"游戏"的位置
    
    if (pos != std::string::npos) {  // npos表示未找到
        log("找到'游戏'，位置: %zd", pos);
        // 提取从找到位置开始的子字符串
        std::string subStr = mainStr.substr(pos);
        log("从位置%d开始的子串: %s", pos, subStr.c_str());
    }
    
    // 3. 字符串替换
    std::string original = "我喜欢C++，C++很有趣";
    std::string replaced = original;
    // 从位置3开始，替换2个字符
    replaced.replace(3, 2, "Cocos2d-x");
    log("替换前: %s", original.c_str());    // 输出: 我喜欢C++，C++很有趣
    log("替换后: %s", replaced.c_str());    // 输出: 我喜欢Cocos2d-x，C++很有趣
}

六、中文字符处理

处理中文字符时需要注意编码问题，Cocos2d-x默认使用UTF-8编码，确保以下几点：

// 中文字符处理
void chineseStringHandling() {
    // 1. 直接使用中文字符串
    std::string chineseStr = "我爱Cocos2d-x游戏开发";
    log("中文字符串: %s", chineseStr.c_str());
    
    // 注意: UTF-8编码的中文字符每个占3个字节
    log("中文字符串长度(字节数): %zd", chineseStr.length());
    log("中文字符串实际字符数: %zd", chineseStr.length() / 3);  // 仅适用于纯中文
    
    // 2. 在Label中显示中文（关键是使用支持中文的字体）
    // 实际项目中这样使用:
    /*
    auto visibleSize = Director::getInstance()->getVisibleSize();
    // 确保simhei.ttf字体文件存在于resources/fonts目录
    auto chineseLabel = Label::createWithTTF(
        "这是中文标签", 
        "fonts/simhei.ttf",  // 使用支持中文的字体
        36
    );
    chineseLabel->setPosition(Vec2(visibleSize.width/2, visibleSize.height/2));
    this->addChild(chineseLabel);
    */
    
    // 3. 中文格式化字符串
    std::string itemName = "黄金剑";
    int itemCount = 5;
    std::string itemInfo = StringUtils::format(
        "你获得了 %d 把 %s",
        itemCount,
        itemName.c_str()
    );
    log("%s", itemInfo.c_str());  // 输出: 你获得了 5 把 黄金剑
}

七、游戏开发中的实际应用

下面是一个综合示例，展示字符串在游戏中的典型用法：

// 游戏中的字符串应用示例
void stringInGameExample() {
    // 模拟游戏数据
    std::string playerName = "无敌战神";
    int score = 0;
    int level = 1;
    float hp = 100.0f;
    
    // 1. 显示玩家信息
    std::string playerInfo = StringUtils::format(
        "===== 玩家信息 =====\n"
        "姓名: %s\n"
        "等级: %d\n"
        "分数: %d\n"
        "生命值: %.0f%%\n"
        "====================",
        playerName.c_str(),
        level,
        score,
        hp
    );
    log("\n%s", playerInfo.c_str());
    
    // 2. 游戏事件处理
    // 玩家得分
    score += 250;
    log("获得250分！%s 当前分数: %d", playerName.c_str(), score);
    
    // 玩家升级
    level += 1;
    std::string levelUpMsg = StringUtils::format(
        "恭喜 %s 升级到 %d 级！",
        playerName.c_str(),
        level
    );
    log("%s", levelUpMsg.c_str());
    
    // 3. 解析配置数据
    std::string configLine = "hp_potion,50,100";  // 物品名,恢复值,价格
    std::vector<std::string> configParts = StringUtils::split(configLine, ",");
    
    if (configParts.size() == 3) {
        std::string itemName = configParts[0];
        int recoverValue = std::stoi(configParts[1]);
        int price = std::stoi(configParts[2]);
        
        log("道具信息: %s，恢复%d点生命值，售价%d金币",
            itemName.c_str(), recoverValue, price);
    }
}

总结

本教程涵盖了Cocos2d-x字符串处理的核心知识点：

1. 推荐使用std::string配合StringUtils工具类
2. 掌握字符串的创建、拼接、比较等基本操作
3. 熟练使用StringUtils::format()进行字符串格式化
4. 掌握字符串与数值之间的相互转换
5. 学会处理中文字符（关键是使用支持中文的字体）
6. 了解字符串在游戏开发中的实际应用场景

字符串处理是游戏开发的基础技能，熟练掌握这些操作可以让你在处理游戏文本、配置数据和用户界面时更加得心应手。在实际项目中，建议封装常用的字符串处理函数，提高代码复用率。