Shane Landrum


Net::ICal::Attendee -- represents an attendee or organizer of a meeting


  use Net::ICal;
  $a = new Net::ICal::Attendee('');
  $a = new Net::ICal::Attendee('',
                                cn => 'Alice Anders',
                role => 'REQ-PARTICIPANT');


Net::ICal::Attendee provides an interface to manipulate attendee data in iCalendar (RFC2445) format.


new($calid, $hash)

New will take a string and optional key-value pairs. The string is the calender user address of the Attendee (usually a mailto uri).

    $a = new Net::ICal::Attendee('');
    $a = new Net::ICal::Attendee('',
                                  cn => 'Alice Anders',
                                  role => 'REQ-PARTICIPANT');

Meaningful hash keys are:

  • cn - common name - the name most people use for this attendee.

  • cutype - type of user this attendee represents. Meaningful values are INDIVIDUAL, GROUP, ROOM, RESOURCE, UNKNOWN.

  • delegated_from - the user who delegated a meeting request to this attendee.

  • delegated_to - the user who's been delegated to handle meeting requests for this attendee.

  • dir - a URI that gives a directory entry associated with the user.

  • partstat - whether this attendee will actually be at a meeting. Meaningful values are NEEDS-ACTION, ACCEPTED, DECLINED, TENTATIVE, DELEGATED, COMPLETED, or IN-PROCESS.

  • role - how this attendee will participate in a meeting. Meaningful values are REQ-PARTICIPANT, OPT-PARTICIPANT, NON-PARTICIPANT, and CHAIR.

  • rsvp - should the user send back a response to this request? Valid values are TRUE and FALSE. FALSE is the default.

  • sent_by - specifies a user who is acting on behalf of this attendee; for example, a secretary for his/her boss, or a parent for his/her 10-year-old.

To understand more about the uses for each of these properties, read the source for this module and and look at RFC2445.


Returns 1 for valid attendee data, undef for invalid.


More documentation pointers can be found in Net::ICal.