What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

mcal_store_event
Prev	XXXVI. MCAL Functions	Next

mcal_store_event

Name

mcal_store_event — Store changes to an event

Synopsis

mixed mcal_store_event(MCALconnection); int MCALconnection: An open MCAL connection

Returns

The unique ID of the event that has been updated, or FALSE on an error

Description

mcal_store_event() saves modifications to an existing event in a calendar. To modify an event, first fetch it using mcal_fetch_event() . Then use the mcal_set_...() functions to change only the attributes of the event that you want to change. Then, call mcal_store_event() to save the changes.

Note

To save a new event you must use mcal_append_event() .

Version

PHP 3 since 3.0.13, PHP 4 since 4.0b4

Example

Example 732. Using mcal_store_event to modify an existing event

$calendar = "{/mstore}<mycalendar>";
$MCALconnection = mcal_open($calendar, "username", "password");
$events = mcal_list_events($MCALconnection, $start_year,
                           $start_month, $start_day
                           $end_year, $end_month,
                           $end_day);
$eventID = $events[0];
echo "Fetching event with ID: " . $eventID . "<br />";
$eventObject = mcal_fetch_event($MCALconnection, $eventID);

// Now use the mcal_set functions to change the event.
mcal_event_set_title("The event has a new title");

// mcal_store_event saves the changes.
$eventID = mcal_store_event($MCALconnection);
echo "The event still has ID: " . $eventID;

Prev	Home	Next
mcal_snooze	Up	mcal_time_valid

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.