C++ Builder进制转换代码出现Range check Error求助

我用C++ Builder实现了一段进制转换代码，原本在控制台环境运行正常，迁移到GUI项目后却触发Range Check Error报错。代码用于将指定数字在不同进制间转换，已排查前端输入合法性问题，调整过for循环条件，均未解决问题。相关函数代码如下：

String convertNumber(String number, int fromBase, int toBase) {

    // Check if the bases are valid (between 2 and 36)
    if (fromBase < 2 || fromBase > 36 || toBase < 2 || toBase > 36) {
        return "Invalid base";
    }

    // Step 1: Convert the input number (in 'fromBase') to a decimal (base 10) number
    int64_t decimalValue = 0;

    for (int i = 1; i <= number.Length(); i++) {  // 1-based indexing
        int digitValue;
        Char currentChar = number[i - 1];  // 0-based access for characters

        // Check if the character is a digit or letter and get the digit's value
        if (isdigit(currentChar)) {
            digitValue = currentChar - '0';  // Convert character '0'-'9' to digit 0-9
        } else if (isalpha(currentChar)) {
            digitValue = toupper(currentChar) - 'A' + 10;  // Convert 'A'-'Z' to 10-35
        } else {
            return "Invalid character in input";  // Handle invalid characters
        }

        // Check if digit value is valid for the base
        if (digitValue >= fromBase) {
            return "Invalid digit for the given base";
        }

        // Convert to decimal value (manual calculation of power of the base)
        decimalValue = decimalValue * fromBase + digitValue;
    }

    // Step 2: Convert the decimal value to the target 'toBase'
    String result = "";
    if (decimalValue == 0) {
        return "0";  // Edge case: if the number is zero, return "0"
    }

    while (decimalValue > 0) {
        int remainder = decimalValue % toBase;

        // Convert the remainder to the corresponding character
        if (remainder < 10) {
            result = String((char)(remainder + '0')) + result;  // For digits 0-9
        } else {
            result = String((char)(remainder - 10 + 'A')) + result;  // For letters A-Z
        }

        decimalValue /= toBase;
    }

    return result;
}

问题根源分析 #

Range Check Error在C++ Builder中通常由以下场景触发：

1. 字符串索引混淆：代码用number[i-1]以0-based方式访问C++ Builder的String（默认1-based索引），虽然逻辑上不会越界，但这种写法容易和C++ Builder的字符串特性冲突，增加潜在风险。
2. 整数溢出触发范围检查：GUI环境下C++ Builder默认开启严格的范围检查编译选项，当输入的高进制（如36进制）数字过长时，decimalValue（int64_t类型）在计算过程中会溢出，触发范围检查报错——而控制台环境可能未开启该选项，因此未暴露问题。

解决方案 #

1. 修正字符串索引方式（符合C++ Builder特性）

C++ Builder的String类原生支持1-based索引，直接使用number[i]访问对应位置的字符，避免0-based索引带来的混淆：

for (int i = 1; i <= number.Length(); i++) {
    Char currentChar = number[i]; // 直接用1-based索引访问
    // 后续逻辑不变
}

2. 添加整数溢出检查（从根源解决问题）

在计算decimalValue前，判断当前值乘以进制数后是否会超出int64_t的最大值，避免溢出触发范围检查：

// 需要包含头文件以使用INT64_MAX
#include <stdint.h>

// ...

// 在计算decimalValue前添加溢出判断
if (decimalValue > (INT64_MAX - digitValue) / fromBase) {
    return "Input number is too large to convert";
}
decimalValue = decimalValue * fromBase + digitValue;

3. 临时关闭局部范围检查（仅用于快速验证）

如果需要快速验证问题，可以在函数前后包裹范围检查关闭指令，仅针对该函数禁用范围检查：

#pragma rangecheck off
String convertNumber(String number, int fromBase, int toBase) {
    // 函数原有内容
}
#pragma rangecheck on

总结 #

最可能的触发原因是长数字转换时的整数溢出，结合GUI环境下的严格范围检查导致报错。优先通过添加溢出检查和修正字符串索引方式解决问题，不建议全局关闭范围检查（会失去越界保护）。

内容的提问来源于stack exchange，提问作者Murchoid