核心定位

strtol 是C语言中字符串转长整型的「多进制翻译官」，它能将数字字符串（如 "123"、"0xFF"、"077"）转换为 long 类型的整数，支持2到36进制。就像一位精通多国语言的翻译，它能理解不同进制的「数字语言」，还能告诉你翻译到哪里结束！

函数原型与参数

long strtol(const char *str, char **endptr, int base);

• 入口参数：
• str：指向待转换字符串的指针
• endptr：指向 char* 的指针，用于存储转换结束的位置
• 智能跳过：自动忽略字符串前的空白符（空格、Tab等）
• 停止条件：遇到第一个非法字符（含字符串结尾的\0）立即停止
• base：进制（2到36）
• 特殊规则：
• 0：自动检测进制（0x 开头为16进制，0 开头为8进制，否则为10进制）
• 16：支持 0x 或 0X 前缀
• 返回参数：
• 成功转换：返回对应的长整型值
• 无效输入：返回 0L，并将 endptr 指向原字符串
• 溢出风险：若数值超出 long 范围，返回 LONG_MAX 或 LONG_MIN，并设置 errno 为 ERANGE

实战代码演示

场景1 基础转换

#include 
#include 

int main() {
    const char *num_str = "12345";  
    char *endptr;
    long num = strtol(num_str, &endptr, 10);  
    printf("转换结果：%ld\n", num);  // 输出：12345
    printf("转换结束位置：'%s'\n", endptr);  // 输出：''（空字符串）
    return 0;
}

场景2 多进制支持

const char *hex_str = "0xFF";  // 16进制
char *endptr;
long hex_num = strtol(hex_str, &endptr, 0);  // 自动检测进制
printf("16进制转换结果：%ld\n", hex_num);  // 输出：255

const char *bin_str = "1010";  // 2进制
long bin_num = strtol(bin_str, &endptr, 2);  
printf("2进制转换结果：%ld\n", bin_num);  // 输出：10

场景3 错误处理

const char *invalid_str = "hello";  
char *endptr;
long result = strtol(invalid_str, &endptr, 10);  
printf("无效输入结果：%ld\n", result);  // 输出：0
printf("转换结束位置：'%s'\n", endptr);  // 输出：'hello'

四大致命陷阱

增强版安全用法

#include 

long safe_strtol(const char *str, int base) {
    if (str == NULL) {
        fprintf(stderr, "输入指针为NULL！\n");
        return 0L;
    }
    
    char *endptr;
    long num = strtol(str, &endptr, base);  //  使用strtol检测错误
    
    // 检查是否整个字符串都被转换
    if (*endptr != '\0') {
        fprintf(stderr, "警告：'%s' 含非数字字符\n", endptr);
    }
    
    // 检查是否溢出
    if (errno == ERANGE) {
        fprintf(stderr, "错误：数值超出long范围！\n");
        return 0L;
    }
    
    return num;
}

// 使用示例
int main() {
    printf("安全转换结果：%ld\n", safe_strtol("2147483647", 10));    // 正常
    printf("安全转换结果：%ld\n", safe_strtol("9223372036854775808", 10)); // 触发溢出警告
    return 0;
}

对比strtol与atol

黄金法则

1. 复杂场景用strtol：需要错误检测、溢出处理或多进制转换时
2. 检查endptr：确保字符串被完整转换，避免部分转换导致逻辑错误
3. 防御性检查：

• 转换前检查指针是否为 NULL
• 转换后检查字符串剩余部分是否合法

4. 替代方案：C++中推荐使用 std::stol，Python用 int()，Java用 Long.parseLong()

脑洞应用：配置文件解析

void parse_config(const char *config) {
    // 示例配置："timeout=30"
    char *endptr;
    long timeout = strtol(config + 8, &endptr, 10);  // 跳过"timeout="
    if (*endptr != '\0') {
        printf("警告：配置值含非法字符 '%s'\n", endptr);
    }
    printf("超时时间：%ld 秒\n", timeout); 
}

// 输入："timeout=30" → 输出30
// 输入："timeout=abc" → 输出0，并提示警告

strtol 如同一位精通多国语言的翻译官——不仅能翻译数字，还能告诉你翻译到哪里结束。掌握它的特性后，在需要「精确翻译」时大胆使用，让你的程序既灵活又稳健！