函数

GLibSourceset_name_by_id

since: 2.26

声明 [src]

void
g_source_set_name_by_id (
  guint tag,
  const char* name
)

描述 [src]

使用源的 ID 设置源名称。

这是一个便捷实用程序，用于从 g_idle_add()、g_timeout_add() 等的返回值设置源名称。

尝试设置不存在源的名称是程序员的错误。

更具体地说：源 ID 在源被销毁后可以重新分配，因此使用可能已删除的源 ID 调用此函数永远是不合法的。例如，当使用 g_idle_add() 在另一个线程中安排空闲操作时，空闲操作可能已经运行并在此函数对其（现在无效的）源 ID 调用前被删除。这个源 ID 可能已被重新分配，导致操作针对错误的源执行。

可用以来：2.26

参数

tag

类型： guint

一个 GSource ID。

name

类型： const char*

源调试名称。

数据由函数的调用者拥有。

该值是一个以 NUL 终止的 UTF-8 字符串。