abstract class Termisu::Event::Poller

• Termisu::Event::Poller
• Reference
• Object

Overview

Abstract base class for I/O event multiplexing.

Provides unified interface for system-level event polling with support for file descriptor monitoring and high-precision timers.

Platform Backends

• Linux: epoll + timerfd for kernel-level timer precision
• macOS/BSD: kqueue with EVFILT_TIMER
• Fallback: POSIX poll with monotonic clock timers

Usage

poller = Termisu::Event::Poller.create

# Register file descriptor for read events
poller.register_fd(stdin_fd, FDEvents::Read)

# Add a 16ms repeating timer (~60 FPS)
timer = poller.add_timer(16.milliseconds)

# Event loop
loop do
  case result = poller.wait
  when nil
    break # Shutdown
  else
    case result.type
    when .timer?
      handle_tick(result.timer_expirations)
    when .fd_readable?
      handle_input(result.fd)
    end
  end
end

poller.close

Thread Safety

Poller instances are NOT thread-safe. Use one poller per fiber/thread. File descriptor operations and timer management should occur on the same fiber that calls #wait.

Direct Known Subclasses

• Termisu::Event::Poller::Linux
• Termisu::Event::Poller::Poll

Defined in:

termisu/event/poller.cr

Constructors

• .create : Poller

  Creates the optimal poller for the current platform.

Instance Method Summary

• #add_timer(interval : Time::Span, repeating : Bool = true) : TimerHandle

  Creates a new timer with the specified interval.

• #close : Nil

  Releases all resources held by the poller.

• #modify_timer(handle : TimerHandle, interval : Time::Span) : Nil

  Modifies an existing timer's interval.

• #register_fd(fd : Int32, events : FDEvents) : Nil

  Registers a file descriptor for event monitoring.

• #remove_timer(handle : TimerHandle) : Nil

  Removes a timer.

• #unregister_fd(fd : Int32) : Nil

  Unregisters a file descriptor from event monitoring.

• #wait(timeout : Time::Span) : PollResult | Nil

  Waits for an event with timeout.

• #wait : PollResult | Nil

  Waits indefinitely for an event.

Constructor Detail

Instance Method Detail