PHP Pocket Reference

MCAL Functions

The MCAL library, available at http://mcal.chek.com, is used to connect to calendars. MCAL supports different protocols, including ICAP. Note that these functions supercede the icap_ functions in PHP:

int mcal_close(int stream_id [, int options])

Close an MCAL stream

string mcal_create_calendar(int stream_id, string calendar)

Create a new calendar

bool mcal_date_valid(int year, int month, int day)

Return true if the date is a valid date

int mcal_day_of_week(int ayear, int amonth, int aday, int byear, int bmonth,int bday)

Compare two dates

int mcal_day_of_week(int year, int month, int day)

Return the day of the week of the given date

int mcal_day_of_year(int year, int month, int day)

Return the day of the year of the given date

int mcal_days_in_month(int month, bool leap_year)

Return the number of days in the given month (needs to know if the year is a leap year or not)

string mcal_delete_calendar(int stream_id, string calendar)

Delete calendar

string mcal_delete_event(int stream_id, int uid)

Delete event

int mcal_event_init(int stream_id)

Initialize a stream’s global event

int mcal_event_set_alarm(int stream_id, int alarm)

Add an alarm to the stream’s global event

string mcal_event_set_category(int stream_id, string category)

Attach a category to an event

int mcal_event_set_class(int stream_id, int class)

Add a class to the stream’s global event

string mcal_event_set_description(int stream_id, string description)

Attach a description to an event

string mcal_event_set_end(int ...