C++实战：被调用函数如何获取调用处的代码行数

1次阅读

没有评论

共计 2462 个字符，预计需要花费 7 分钟才能阅读完成。

在 C ++ 开发中，尤其是调试和日志记录场景，我们经常需要在被调用函数中获取调用方的代码位置信息。比如：

当某个通用函数出现异常时，需要精确定位是哪个调用点传入了非法参数
记录日志时需要自动附加调用位置信息，避免手动填写行号
实现断言宏时需要在报错信息中显示触发位置

传统做法是手动传递 __LINE__ 宏，但这种方式需要修改所有调用点，维护成本高。我们需要一种自动获取调用方行号的机制。

1. 基础 `LINE` 宏方案

最直接的方式是通过参数传递行号：

void logError(const char* message, int line) {std::cerr << "Error at line" << line << ":" << message;}

// 调用时
logError("Something wrong", __LINE__);

优点：
– 实现简单
– 所有编译器都支持

缺点：
– 需要修改所有调用点
– 容易遗漏参数传递

现代编译器提供内置函数可直接获取调用方信息：

GCC/Clang 的__builtin_LINE()
MSVC 的 __LINE__ 结合调用约定

void logError(const char* message) {std::cerr << "Error at line" << __builtin_LINE() << ":" << message;
}

优点：
– 调用方无需额外参数
– 编译器优化后开销小

缺点：
– 不同编译器语法不一致
– 某些旧版本不支持

结合宏和默认参数实现透明传递：

#define LOG_ERROR(msg) logError(msg, __LINE__)

void logError(const char* message, int line = __builtin_LINE());

优点：
– 兼容性好
– 调用方使用自然

缺点：
– 宏可能污染命名空间
– 需要处理宏展开的特殊情况

// line_info.h
#pragma once

#include <cstdio>

#ifdef _MSC_VER
#define CALLER_LINE() __LINE__
#elif defined(__GNUC__) || defined(__clang__)
#define CALLER_LINE() __builtin_LINE()
#else
#define CALLER_LINE() 0
#endif

void debugLog(const char* message, const char* file = "", int line = CALLER_LINE());

// 宏包装简化调用
#define LOG(msg) debugLog(msg, __FILE__, CALLER_LINE())

// line_info.cpp
#include "line_info.h"
#include <iostream>

void debugLog(const char* message, const char* file, int line) {std::cerr << "[" << file << ":" << line << "]" << message << "\n";
}

cmake_minimum_required(VERSION 3.10)
project(line_info_demo)

set(CMAKE_CXX_STANDARD 17)

# 定义不同平台的编译选项
if(MSVC)
    add_compile_definitions(_MSC_VER)
elseif(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
    add_compile_options(-Wall -Wextra)
endif()

add_library(line_info STATIC line_info.cpp)

编译器	支持特性	备注
GCC ≥4.8	`__builtin_LINE()`	最优实现
Clang ≥3.5	`__builtin_LINE()`	同 GCC
MSVC ≥2015	`__LINE__`	需特殊处理调用栈
其他	回退方案	返回 0 值

使用 Google Benchmark 对比三种实现：

#include <benchmark/benchmark.h>
#include "line_info.h"

static void BM_ManualLine(benchmark::State& state) {for (auto _ : state) {debugLog("test", __FILE__, __LINE__);
    }
}
BENCHMARK(BM_ManualLine);

static void BM_BuiltinLine(benchmark::State& state) {for (auto _ : state) {LOG("test");
    }
}
BENCHMARK(BM_BuiltinLine);

BENCHMARK_MAIN();

测试结果（Intel i7-1185G7 @3.0GHz）：