# 5.2 停止循環 如果想在移除所有已注冊的事件之前停止活動的事件循環,可以調用兩個稍有不同的函數 。 ```cpp int event_base_loopexit(struct event_base *base, const struct timeval *tv); int event_base_loopbreak(struct event_base *base); ``` **event_base_loopexit()**讓 event_base 在給定時間之后停止循環。如果 tv 參數為 NULL, event_base 會立即停止循環,沒有延時。 如果 event_base 當前正在執行任何激活事件的回調,則回調會繼續運行,直到運行完所有激活事件的回調之才退出。 **event_base_loopbreak ()**讓 event_base 立即退出循環。它與 event_base_loopexit (base,NULL)的不同在于,如果 event_base 當前正在執行激活事件的回調 ,它將在執行完當前正在處理的事件后立即退出。 >注意 event_base_loopexit(base,NULL) 和 event_base_loopbreak(base) 在事件循環沒有運行時的行為不同:前者安排下一次事件循環在下一輪回調完成后立即停止(就好像帶 EVLOOP_ONCE 標志調用一樣);后者卻僅僅停止當前正在運行的循環,如果事件循環沒 有運行,則沒有任何效果。 這兩個函數都在成功時返回 0,失敗時返回 -1。 ###實例： ```cpp #include <event2/event.h> /* Here's a callback function that calls loopbreak */ void cb(int sock, short what, void *arg) { struct event_base *base = arg; event_base_loopbreak(base); } void main_loop(struct event_base *base, evutil_socket_t watchdog_fd) { struct event *watchdog_event; /* Construct a new event to trigger whenever there are any bytes to read from a watchdog socket. When that happens, we'll call the cb function, which will make the loop exit immediately without running any other active events at all. */ watchdog_event = event_new(base, watchdog_fd, EV_READ, cb, base); event_add(watchdog_event, NULL); event_base_dispatch(base); } ``` ###實例2：執行事件循環10秒，然后退出 ```cpp #include <event2/event.h> void run_base_with_ticks(struct event_base *base) { struct timeval ten_sec; ten_sec.tv_sec = 10; ten_sec.tv_usec = 0; /* Now we run the event_base for a series of 10-second intervals, printing "Tick" after each. For a much better way to implement a 10-second timer, see the section below about persistent timer events. */ while (1) { /* This schedules an exit ten seconds from now. */ event_base_loopexit(base, &ten_sec); event_base_dispatch(base); puts("Tick"); } } ``` 有時候需要知道對 event_base_dispatch()或者 event_base_loop()的調用是正常退出 的,還是因為調用 event_base_loopexit()或者 event_base_break()而退出的。可以調 用下述函數來確定是否調用了 loopexit 或者 break函數。 ```cpp int event_base_got_exit(struct event_base *base); int event_base_got_break(struct event_base *base); ``` 這兩個函數分別會在循環是因為調用 event_base_loopexit()或者 event_base_break()而退出的時候返回 true,否則返回 false。下次啟動事件循環的時候,這些值會被重設。 這些函數聲明在<event2/event.h>中。 event_break_loopexit()函數首次在 libevent 1.0c 版本 中實現; event_break_loopbreak()首次在 libevent 1.4.3版本中實現。