NAME
          irCid2Chan - convert a channel identifier to a channel
          number

     SYNOPSIS
          #include <irapi.h>

          int irCid2Chan (channel_id cid);

     DESCRIPTION
          The irCid2Chan function returns a channel number associated
          with the channel identifier (cid). Channel numbers refer to
          hardware components and are useful when reporting errors.

     EVENT
          No event results from the call to irCid2Chan.

     RETURN VALUE
          A channel number is returned if the request is successful.

          IRR_FAIL is returned if an error occurs.

     ERROR
          irError is set to IRER_INVALID if the cid is invalid

     SEE ALSO
          irChan2Cid(3IRAPI)

     VERSION
          This is version 8/31/00 of this man page.