函数

GLibtest_build_filename

自 2.38 起

声明 [src]

gchar*
g_test_build_filename (
  GTestFileType file_type,
  const gchar* first_path,
  ...
)

描述 [src]

创建 a 测试所需的数据文件的路径名。

此函数在概念上与 g_build_filename() 类似，只是第一个参数已替换为 GTestFileType 参数。

数据文件要么与包含测试的模块一起分发（G_TEST_DIST），要么作为该模块的 buildcsystem 的一部分构建（G_TEST_BUILT）。

为使此功能在 srcdir != builddir 态势下正常工作，需要已经定义了 G_TEST_SRCDIR 和 G_TEST_BUILDDIR 环境变量。从 2.38 开始，这可通过 GLib 中包含的 glib.mk 完成。请确保在使用此 函数之前，你的副本是最新的。

如果这两个变量都没有设置，此函数将回退至使用 argv[0] 的 dirname 部分，可能会移除 “.libs”。在 srcdir == builddir 的情况下，这允许从命令行直接随意运行测试，并且也应该支持安装的测试的运行，前提是数据文件已安装在与测试二进制文件相同的相对路径中。

从 2.38 开始提供

此函数不能直接供语言绑定使用。

参数

file_type

类型： GTestFileType

文件的类型（构建的与分发的）。

first_path

类型： const gchar*

路径名的第一部分。

数据由函数调用者所有。
值是一个空终止的 UTF-8 字符串。
...

类型： 

NULL 终止的附加路径 段。

返回值

类型： gchar*

文件的路径，使用 g_free() 释放。

函数调用者拥有数据的完全所有权，并负责释放它。
值是一个空终止的 UTF-8 字符串。