g_timeout_add_seconds()是 GLib 库中的一个函数，用于在指定秒数后执行回调函数。它是 GTK+/GLib 应用程序中常用的定时器函数。
函数原型
guint g_timeout_add_seconds(guint interval, GSourceFunc function, gpointer data);参数说明
interval
类型:
guint(无符号整数)说明: 时间间隔，单位为秒
注意: 实际触发时间可能会有微小延迟，精度不如
g_timeout_add()
function
类型:
GSourceFunc(函数指针)说明: 要执行的回调函数
函数签名:
gboolean callback(gpointer data)返回值:
TRUE: 继续执行定时器FALSE: 停止定时器
data
类型:
gpointer(通用指针)说明: 传递给回调函数的用户数据
返回值
类型:
guint说明: 事件源ID，可用于取消定时器
基本用法示例
#include <glib.h> #include <stdio.h> gboolean my_callback(gpointer data) { static int count = 0; printf("回调函数被调用，计数: %d\n", ++count); // 执行5次后停止 if (count >= 5) { printf("停止定时器\n"); return FALSE; // 返回FALSE停止定时器 } return TRUE; // 返回TRUE继续定时器 } int main() { // 每2秒执行一次回调函数 guint timer_id = g_timeout_add_seconds(2, my_callback, NULL); // 创建主循环 GMainLoop *loop = g_main_loop_new(NULL, FALSE); g_main_loop_run(loop); return 0; }与g_timeout_add()的区别
// 毫秒级精度 guint g_timeout_add(guint interval, // 毫秒 GSourceFunc function, gpointer data); // 秒级精度（优化功耗） guint g_timeout_add_seconds(guint interval, // 秒 GSourceFunc function, gpointer data);主要区别:
精度:
g_timeout_add()使用毫秒，g_timeout_add_seconds()使用秒功耗:
g_timeout_add_seconds()在移动设备上更节能系统唤醒:
g_timeout_add_seconds()会合并多个定时器，减少系统唤醒次数
高级用法
1. 传递参数给回调函数
typedef struct { int max_count; char *message; } MyData; gboolean callback_with_data(gpointer user_data) { MyData *data = (MyData *)user_data; static int count = 0; printf("%s - 调用次数: %d/%d\n",>static guint timer_id = 0; gboolean my_callback(gpointer data) { printf("定时器执行\n"); return TRUE; } void start_timer() { timer_id = g_timeout_add_seconds(1, my_callback, NULL); } void stop_timer() { if (timer_id > 0) { g_source_remove(timer_id); timer_id = 0; } }3. 一次性定时器
gboolean one_shot_callback(gpointer data) { printf("这个函数只执行一次\n"); // 做一些清理工作... g_free(data); return FALSE; // 返回FALSE确保只执行一次 } void schedule_one_shot() { // 5秒后执行一次 g_timeout_add_seconds(5, one_shot_callback, some_data); }实际应用场景
1. GUI 界面更新
// 定期更新UI状态 gboolean update_ui(gpointer data) { GtkLabel *label = GTK_LABEL(data); time_t now = time(NULL); char buffer[100]; strftime(buffer, sizeof(buffer), "当前时间: %H:%M:%S", localtime(&now)); gtk_label_set_text(label, buffer); return TRUE; // 继续更新 } // 每秒更新一次时间显示 gtk_timeout_add_seconds(1, (GSourceFunc)update_ui, label);2. 网络请求重试
gboolean retry_network_request(gpointer data) { HttpRequest *request = (HttpRequest *)data; if (request->retry_count >= MAX_RETRIES) { g_signal_emit(request, "failed", 0); g_object_unref(request); return FALSE; } if (send_http_request(request)) { g_object_unref(request); return FALSE; } request->retry_count++; return TRUE; // 继续重试 } void send_request_with_retry(HttpRequest *request) { // 每10秒重试一次 g_timeout_add_seconds(10, retry_network_request, g_object_ref(request)); }3. 自动保存功能
gboolean autosave_document(gpointer data) { Document *doc = (Document *)data; if (doc->modified) { save_document(doc); doc->modified = FALSE; printf("文档已自动保存\n"); } return TRUE; } void enable_autosave(Document *doc) { // 每30秒自动保存一次 g_timeout_add_seconds(30, autosave_document, doc); }注意事项
线程安全: 回调函数在主线程中执行，如果需要进行耗时操作，应考虑使用线程
内存管理: 传递动态分配的数据时，需要确保适当释放
精度限制: 秒级定时器不适合高精度需求
功耗优化: 在移动应用中优先使用
g_timeout_add_seconds()主循环: 必须有正在运行的
GMainLoop才能触发定时器
常见问题解决
问题1: 定时器不触发
原因: 没有运行主事件循环
// 错误：没有主循环 g_timeout_add_seconds(1, callback, NULL); // 这里缺少 g_main_loop_run() // 正确：运行主循环 GMainLoop *loop = g_main_loop_new(NULL, FALSE); g_timeout_add_seconds(1, callback, NULL); g_main_loop_run(loop);问题2: 内存泄漏
// 错误：可能的内存泄漏 g_timeout_add_seconds(1, callback, g_strdup("data")); // 正确：在回调中释放 gboolean callback(gpointer data) { char *str = (char *)data; printf("%s\n", str); g_free(str); // 记得释放 return FALSE; }问题3: 回调函数中修改UI
// 错误：在非主线程中更新UI gboolean update_ui(gpointer data) { // 如果在其他线程中执行，这可能导致问题 gtk_label_set_text(GTK_LABEL(data), "更新文本"); return FALSE; } // 正确：使用 g_idle_add() 确保在主线程中更新UI gboolean update_ui_safe(gpointer data) { g_idle_add((GSourceFunc)actual_ui_update, data); return FALSE; }g_timeout_add_seconds()是 GLib 中非常实用的定时器函数，特别适合需要定期执行任务但又不需要高精度的场景。正确使用时，可以大大简化应用程序的定时任务管理。
