Главная Статьи Написать
 
Начнём
Введение
Инсталяция
Конфигурирование
Безопасность
Справочник Языка
Базовый синтаксис
Типы
Переменные
Константы
Выражения
Операции
Структуры управления
Функции
Классы и Объекты
Ссылки. Разъяснение.
Возможности
Обработка Ошибок
Создание изображений и манипуляции с ними
HTTP-аутентификация в PHP
Куки
Обработка загрузки файлов
Использование удалённых файлов
Обслуживание соединений
Постоянные соединения с базами данных
Безопасный режим
Использование PHP из командной строки
Функции. Справочник.
Функции, специфические для Apache
Array-функции
Aspell-функции [не рекомендуются]
BCMath математические функции произвольной точности
Bzip2 Compression-функции
Calendar-функции
CCVS API-функции
Функции поддержки COM для Windows
Class/Object-функции
ClibPDF-функции
Crack-функции
CURL, Client URL Library-функции
Cybercash payment-функции
Crédit Mutuel CyberMUT-функции
Cyrus IMAP -функции администрирования
Функции типов символов
Функции абстрактного слоя БД (dbm-стиль)
Дата и Время
dBase-функции
DBM-функции
dbx-функции
DB++-функции
Direct IO-функции
Функции директорий
DOM XML-функции
.NET-функции
Обработка ошибок и логинг
FrontBase-функции
filePro-функции
Функции файловой системы
Forms Data Format-функции
FriBiDi-функции
FTP-функции
Функции работы с функциями
Gettext
GMP-функции
HTTP-функции
Hyperwave-функции
Hyperwave API-функции
ICAP-функции [не рекомендуются]
iconv-функции
Image-функции
IMAP, POP3 и NNTP-функции
Informix-функции
InterBase-функции
Ingres II-функции
IRC Gateway-функции
Java
LDAP-функции
Mail-функции
mailparse-функции
Mathematical-функции
Многобайтные строки
MCAL-функции
Mcrypt Encryption-функции
Mhash-функции
Mimetype-функции
Microsoft SQL Server-функции
Ming-функции для Flash
Прочие функции
mnoGoSearch-функции
mSQL-функции
MySQL-функции
Mohawk Software -функции обработчика сессии
muscat-функции
Network-функции
Ncurses -функции управления терминалом
Lotus Notes-функции
Unified ODBC-функции
Oracle 8-функции
OpenSSL-функции
Oracle-функции
Ovrimos SQL-функции
Управление выводом
Перегрузка свойств объектов и вызовов методов
PDF-функции
Verisign Payflow Pro-функции
PHP. Опции & Информация
POSIX-функции
PostgreSQL-функции
Управление процессом
Выполнение программы
Printer-функции
Pspell-функции
GNU Readline
GNU Recode-функции
Функции регулярных выражений (Perl-совместимые)
qtdom-функции
Функции регулярных выражений (POSIX расширенная)
Semaphore, Shared Memory и IPC-функции
SESAM database-функции
Обслуживание сессий
Shared Memory-функции
Shockwave Flash-функции
SNMP-функции
Socket-функции
String-функции
Sybase-функции
URL-функции
Функции переменных
vpopmail-функции
W32api-функции
WDDX-функции
XML parser-функции
XMLRPC-функции
XSLT-функции
YAZ-функции
YP/NIS-функции
Zip File-функции (доступ только для чтения)
Zlib Compression-функции
Расширение PHP 4.0
Обзор
Возможность расширения
Строение исходного кода
Система автоматического построения РНР
Создание расширений
Использование расширений
Решение проблем
Исходные Ресурсы. Обсуждение.
Приём аргументов
Создание переменных
Дублирование содержимого переменной: конструктор Copy
Возвращаемые значения
Печать информации
Startup и Shutdown-функции
Вызов пользовательских функций
Поддержка файлов инициализации
Что дальше?
Справочник: некоторые макросы конфигурации
Макросы API
FAQ: Frequently Asked Questions
Общая информация
Списки рассылки
Получение PHP
Вопросы о базах данных
Инсталяция
Проблемы построения
Использование PHP
PHP и HTML
PHP и COM
PHP и другие языки
Переход от PHP 2 к PHP 3
Переход от PHP 3 к PHP 4
Другие вопросы
Приложения
История PHP и смежных проектов
Переход от PHP 3 к PHP 4
Переход от PHP/FI 2 к PHP 3
Отладка PHP
Расширение PHP
Список псевдонимов функций
Список зарезервированных слов
Список типов ресурсов
Список лексем разборщика
Об этом учебнике




LIV. Функции MCAL

MCAL это Modular Calendar Access Library.

Libmcal это библиотека C для доступа к календарям. Она написана как модульная, с подключаемыми драйверами. MCAL это календарный эквивалент IMAP-модуля для mailboxes/почтовых ящиков.

При поддержке mcal, календарный поток может быть открыт почти так же, как mailbox-поток с поддержкой IMAP. Календари могут быть локальными файлами, удалёнными ICAP-серверами или другими форматами, которые поддерживаются библиотекой mcal.

Календарные события могут быть направлены в пул, запрошены или сохранены. Имеется также поддержка календарных тригеров (предупреждений) и повторяющихся событий.

С помощью libmcal можно получать доступ к календарным серверам без необходимости использования локального программирования или специфической БД.

Для того чтобы эти функции работали, вы должны скомпилировать PHP с опцией --with-mcal. Это требует установленной библиотеки mcal. Скачайте последнюю версию с http://mcal.chek.com/ и скомпилируйте и установите её.

Следующие константы определены при использовании модуля MCAL. Для дней недели:

  • MCAL_SUNDAY

  • MCAL_MONDAY

  • MCAL_TUESDAY

  • MCAL_WEDNESDAY

  • MCAL_THURSDAY

  • MCAL_FRIDAY

  • MCAL_SATURDAY

Для повторений:

  • MCAL_RECUR_NONE

  • MCAL_RECUR_DAILY

  • MCAL_RECUR_WEEKLY

  • MCAL_RECUR_MONTHLY_MDAY

  • MCAL_RECUR_MONTHLY_WDAY

  • MCAL_RECUR_YEARLY

Для месяцев:

  • MCAL_JANUARY

  • MCAL_FEBRUARY

  • MCAL_MARCH

  • MCAL_APRIL

  • MCAL_MAY

  • MCAL_JUNE

  • MCAL_JULY

  • MCAL_AUGUST

  • MCAL_SEPTEMBER

  • MCAL_OCTOBER

  • MCAL_NOVEMBER

  • MCAL_DECEMBER

Большинство функций используют внутреннюю структуру событий, которая уникальна для каждого потока. Это избавляет от необходимости передавать большие объекты между функциями. Имеются удобные функции для настройки, инициализации и запрашивания значений структуры событий.

Содержание
mcal_append_event - сохраняет новое событие в MCAL-календаре
mcal_close - закрывает поток MCAL
mcal_create_calendar - создаёт новый MCAL-календарь
mcal_date_compare - сравнивает две даты
mcal_date_valid — возвращает TRUE, если данный год, месяц, день является верной датой
mcal_day_of_week — возвращает день недели для данной даты
mcal_day_of_year — возвращает день года для данной даты
mcal_days_in_month — возвращает количество дней в данном месяце
mcal_delete_calendar - удаляет MCAL-календарь
mcal_delete_event - удаляет событие из MCAL-календаря
mcal_event_add_attribute - добавляет атрибут и значение в структуру глобальных событий потока
mcal_event_init - инициализирует структуру глобальных событий потока
mcal_event_set_alarm - устанавливает напоминание/alarm структуры глобальных событий потока
mcal_event_set_category - устанавливает категорию структуры глобальных событий потока
mcal_event_set_class - устанавливает класс структуры глобальных событий потока
mcal_event_set_description - устанавливает описание структуры глобальных событий потока
mcal_event_set_end - устанавливает конечную дату и время структуры глобальных событий потока
mcal_event_set_recur_daily - устанавливает повторение структуры глобальных событий потока
mcal_event_set_recur_monthly_mday - устанавливает повторение структуры глобальных событий потока
mcal_event_set_recur_monthly_wday - устанавливает повторение структуры глобальных событий потока
mcal_event_set_recur_none - устанавливает повторение структуры глобальных событий потока
mcal_event_set_recur_weekly - устанавливает повторение структуры глобальных событий потока
mcal_event_set_recur_yearly - устанавливает повторение структуры глобальных событий потока
mcal_event_set_start - устанавливает начальную дату и время структуры глобальных событий потока
mcal_event_set_title - устанавливает заголовок/title структуры глобальных событий потока
mcal_expunge - удаляет все события, помеченные как вычёркиваемые
mcal_fetch_current_stream_event — возвращает объект, содержащий структуру событий текущего потока
mcal_fetch_event - извлекает событие из календарного потока
mcal_is_leap_year — является данный год високосным, или нет
mcal_list_alarms - возвращает список событий, имеющих включённое уведомление для данной даты/времени
mcal_list_events - возвращает список ID'ов для даты или диапазона дат
mcal_next_recurrence — возвращает следующее повторение события
mcal_open - открывает MCAL-соединение
mcal_popen - открывает постоянное MCAL-соединение
mcal_rename_calendar - переименовывает MCAL-календарь
mcal_reopen - повторно открывает MCAL-соединение
mcal_snooze - выключает уведомление о событии
mcal_store_event - модифицирует существующее событие в MCAL-календаре
mcal_time_valid — возвращает TRUE, если данный год, месяц, день является верным временем
mcal_week_of_year — возвращает номер недели для данной даты