wllistener(3) Wayland wllistener(3)

NAME
       wllistener -

       A single listener for Wayland signals.


SYNOPSIS
       #include 

   Data Fields
       struct wllist link
       wlnotifyfunct notify

Detailed Description
       A single listener for Wayland signals.

       wllistener provides the means to listen for wlsignal notifications.
       Many Wayland objects use wllistener for notification of significant
       events like object destruction.

       Clients should create wllistener objects manually and can register
       them as listeners to signals using wlsignaladd, assuming the signal
       is directly accessible. For opaque structs like wleventloop, adding a
       listener should be done through provided accessor methods. A listener
       can only listen to one signal at a time.

       * struct wllistener yourlistener;
       *
       * yourlistener.notify = yourcallbackmethod;
       *
       * // Direct access
       * wlsignaladd(&someobject->destroysignal, &yourlistener);
       *
       * // Accessor access
       * wleventloop *loop = ...;
       * wleventloopadddestroylistener(loop, &yourlistener);
       *

       If the listener is part of a larger struct, wlcontainerof can be used
       to retrieve a pointer to it:

       * void yourlistener(struct wllistener *listener, void *data)
       * {
       *       struct yourdata *data;
       *
       *       yourdata = wlcontainerof(listener, data, yourmembername);
       * }
       *

       If you need to remove a listener from a signal, use wllistremove().

       * wllistremove(&yourlistener.link);
       *

       See Also:
           wlsignal

Field Documentation
   struct wllist wllistener::link
   wlnotifyfunct wllistener::notify
Author
       Generated automatically by Doxygen for Wayland from the source code.



Version 1.15.0                  Tue Oct 30 2018                 wllistener(3)