Учебник PHP

         

ccvs_sale

(PHP 4 >= 4.0.2)

ccvs_sale - переносит фонды с кредитной карты продавцу.

Описание

string ccvs_sale (string session, string invoice)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ccvs_status

(PHP 4 >= 4.0.2)

ccvs_status - проверяет статус счёта.

Описание

string ccvs_status (string session, string invoice)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ccvs_textvalue

(PHP 4 >= 4.0.2)

ccvs_textvalue - получает текстовое return-значение предыдущего вызова функции.

Описание

string ccvs_textvalue (string session)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ccvs_void

(PHP 4 >= 4.0.2)

ccvs_void - выполняет полную перестановку на завершённой транзакции.

Описание

string ccvs_void (string session, string invoice)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ceil

(PHP 3, PHP 4)

ceil - округляет дроби в сторону увеличения.

Описание

float ceil (float value)

Возвращает следующее ближайшее целочисленное значение путём округления value, если это необходимо.
return-значение ceil() сохраняет тип


float, так как диапазон значений float обычно больше, чем у integer.

chdir

(PHP 3, PHP 4)

chdir - смена директории.

Описание

bool chdir (string directory)

Изменяет текущую директорию для РНР на directory. Возвращает FALSE, если не может сменить директорию, TRUE в ином случае.

checkdate

(PHP 3, PHP 4)

checkdate - проверяет григорианскую дату/время.

Описание

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

Возвращает TRUE, если предоставленные данные верны; иначе возвращает FALSE. Проверяет правильность даты, сформированной аргументами.
Дата считается правильной, если:

year (год) имеет значение от 1 до 32767 включительно.

month (месяц) имеет значение от 1 до 12 включительно.

Day (день месяца) находится в пределах допустимого количества дней для данного month. Високосные годы также учитываются.

См. также mktime() и strtotime().

checkdnsrr

(PHP 3, PHP 4)

checkdnsrr - проверяет записи DNS, соответствующие данному Internet хост-имени/host name или IP-адресу.

Описание

int checkdnsrr (string host [, string type])

Ищет DNS для записи типа type, соответствующего host. Возвращает TRUE, если какие-либо записи найдены; возвращает FALSE, если записи не были найдены или если возникла ошибка.

type может быть: A, MX, NS, SOA, PTR, CNAME или ANY. По умолчанию MX.

Host это может быть либо IP-адрес в нотации dotted-quad, либо имя хоста.

Примечание: эта функция не реализована для платформ Windows.

См. также getmxrr(), gethostbyaddr(), gethostbyname() и gethostbynamel().

chgrp

(PHP 3, PHP 4)

chgrp - изменяет группу файла.

Описание

int chgrp (string filename, mixed group)

Пытается изменить группу файла filename на group (специфицированную числом или именем). Только superuser может изменять группу любого файла; другой пользователь может изменять группу файла на любую группу, членом которой данный пользователь является.

Возвращает TRUE при успехе, FALSE при неудаче.

См. также chown() и chmod().

Примечание: эта функция не реализована для платформ Windows.

chmod

(PHP 3, PHP 4)

chmod - изменяет режим/mode файла.

Описание

int chmod (string filename, int mode)

Пытается изменить режим файла filename на данный режим mode.

Обратите внимание, что mode не принимается автоматически как 8-ричное значение, поэтому строки (такие как "g+w") не будут работать корректно. Для гарантированного выполнения операции вы должны ввести префикс нуль (0) для mode:

chop

(PHP 3, PHP 4)

chop - псевдоним для rtrim().

Описание

Эта функция является псевдонимом для функции rtrim().

Примечание: chop() отличается тем, что Perl-функция chop() удаляет последний символ строки.

chown

(PHP 3, PHP 4)

chown - изменяет владельца файла.

Описание

int chown (string filename, mixed user)

Пытается изменить владельца/owner файла filename на пользователя user (специфицированного именем или числом). Только superuser может изменить владельца файла.

Возвращает TRUE при успехе, FALSE при неудаче.

См. также chown() и chmod().

Примечание: эта функция не реализована для платформ Windows.

chr

(PHP 3, PHP 4)

chr - возвращает специфический символ.

Описание

string chr (int ascii)

Возвращает строку из одного символа, содержащую символ, специфицированный параметром ascii.

chroot

(PHP 4 >= 4.0.5)

chroot - изменяет корневую директорию.

Описание

bool chroot (string directory)

Изменяет корневую директорию текущего процесса на директорию directory. Возвращает FALSE, если не может изменить корневую директорию, TRUE в ином случае.

Примечание: неразумно использовать эту функцию при запуске в среде web-сервера, так как невозможно вновь установить корневую директорию в конце запроса. Эта функция будет корректна только при запуске как CGI.

chunk_split

(PHP 3>= 3.0.6, PHP 4)

chunk_split - делит строку на небольшие куски.

Описание

string chunk_split (string body [, int chunklen [, string end]])

Может использоваться для разделения строки на маленькие куски, которые используются, например, для конвертации base64_encode вывода, для соответствия семантике RFC 2045. Она вставляет end (по умолчанию это "\r\n") для каждого участка символов chunklen (по умолчанию 76). Возвращает новую строку, не изменяя строки-оригинала.

class_exists

(PHP 4)

class_exists - проверяет, был ли класс определён.

Описание

bool class_exists (string class_name)

Эта функция возвращает TRUE, если класс, заданный в class_name, был определён, FALSE в ином случае.

clearstatcache

(PHP 3, PHP 4)

clearstatcache - очищает stat-кэш.

Описание

void clearstatcache (void)

Сделать системный вызов stat или lstat в большинстве систем является довольно затратным процессом. Поэтому результат последнего вызова любой из нижеследующих функций статуса хранится для использования в последующем таком вызове с использованием того же самого filename/имени файла. Если вы хотите форсировать новую проверку статуса, например, если файл проверяется многократно и может измениться или исчезнуть, используйте эту функцию для очистки в памяти результатов последнего вызова.

Эта переменная кэшируется на период существования одного запроса.

Воздействует на функции stat(), lstat(), file_exists(), is_writable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype() и fileperms().

closedir

(PHP 3, PHP 4)

closedir - закрывает дескриптор директории.

Описание

void closedir (resource dir_handle)

Закрывает поток директории, обозначенный параметром dir_handle. Этот поток обязан быть ранее открыт функцией opendir().

closelog

(PHP 3, PHP 4)

closelog - закрывает соединение с системным логером.

Описание

int closelog (void)

closelog() закрывает дескриптор, используемый для записи в системный логер. Использование closelog() является необязательным/optional.

См. также define_syslog_variables(), syslog() и openlog().

com_addref

(PHP 4 >= 4.1.0)

com_addref - увеличивает значение счётчика ссылок.

Описание

void com_addref (void)

Увеличивает значение счётчика ссылок на компоненты.

com_get

(PHP 3>= 3.0.3, PHP 4 >= 4.0.5)

com_get - получает значение свойства COM-компонента.

Описание

mixed com_get (resource com_object, string property)

Возвращает значение свойства property COM-компонента, на который ссылается com_object. Возвращает FALSE в случае ошибки.

com_invoke

(PHP 3>= 3.0.3)

com_invoke - вызывает метод COM-компонента.

Описание

mixed com_invoke (resource com_object, string function_name [, mixed function parameters, ...])

com_invoke() вызывает метод COM-компонента, на который ссылается com_object. Возвращает FALSE в случае ошибки, возвращает return-значение function_name в случае успеха.

com_isenum

(PHP 4 >= 4.1.0)

com_isenum - "сдирает" IEnumVariant.

Описание

void com_isenum (object com_module)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

com_load

(PHP 3>= 3.0.3)

com_load - создаёт новую ссылку на COM-компонент.

Описание

string com_load (string module name [, string server name [, int codepage]])

com_load() создаёт новый COM-компонент и возвращает ссылку на него. Возвращает FALSE при неудаче. Возможные значения для codepage: CP_ACP, CP_MACCP, CP_OEMCP, CP_SYMBOL, CP_THREAD_ACP, CP_UTF7 и CP_UTF8.

com_load_typelib

(PHP 4 >= 4.1.0)

com_load_typelib - загружает Typelib.

Описание

void com_load_typelib (string typelib_name [, int case_insensitive])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

com_propget

(PHP 3>= 3.0.3, PHP 4 >= 4.0.5)

com_propget - получает значение свойства COM-компонента.

Описание

mixed com_propget (resource com_object, string property)

Это псевдоним для функции com_get().

com_propput

(PHP 3>= 3.0.3, PHP 4 >= 4.0.5)

com_propput - присваивает значение свойству COM-компонента.

Описание

void com_propput (resource com_object, string property, mixed value)

Это псевдоним для функции com_set().

com_propset

(PHP 3>= 3.0.3, PHP 4 >= 4.0.5)

com_propset - присваивает значение свойству COM-компонента.

Описание

void com_propset (resource com_object, string property, mixed value)

Это псевдоним для функции com_set().

com_release

(PHP 4 >= 4.1.0)

com_release - уменьшает значение счётчика ссылок на компоненты.

Описание

void com_release (void)

Уменьшает счётчик ссылок на компоненты.

com_set

(PHP 3>= 3.0.3, PHP 4 >= 4.0.5)

com_set - присваивает значение свойству COM-компонента.

Описание

void com_set (resource com_object, string property, mixed value)

Устанавливает значение свойства property COM-компонента, на который ссылается com_object. Возвращает вновь установленное значение в случае успеха, FALSE -при ошибке.

compact

(PHP 4)

compact - создаёт массив, содержащий переменные и их значения.

Описание

array compact (mixed varname [, mixed ...])

compact() принимает переменное количество параметров. Каждый параметр может быть строкой, содержащей имя переменной, или массивом имён переменных. Массив может содержать другие массивы имён переменных; compact() обрабатывает их рекурсивно.

Для каждого имени функция compact() ищет переменную с данным именем в текущей таблице символов и добавляет его в массив вывода так, что имя переменной становится ключом, а содержимое переменной становится значением этого ключа. Короче говоря, она выполняет действия, противоположные действиям функции extract(). Она возвращает массив вывода со всеми переменными, добавленными в него.

Любые строки, которые не установлены, просто пропускаются.

connection_aborted

(PHP 3>= 3.0.7, PHP 4)

connection_aborted - возвращает TRUE, если клиент отсоединён.

Описание

int connection_aborted (void)

Возвращает TRUE, если клиент отсоединён. См. описание "Обслуживание соединений" в главе Возможности.

connection_status

(PHP 3>= 3.0.7, PHP 4)

connection_status - возвращает битовое поле статуса соединения.

Описание

int connection_status (void)

Возвращает битовое поле статуса соединения. См. описание "Обслуживание соединений" в главе Возможности.

connection_timeout

(PHP 3>= 3.0.7, PHP 4 <= 4.0.4)

connection_timeout - возвращает TRUE, если скрипт сделал паузу.

Описание

bool connection_timeout (void)

Возвращает TRUE, если скрипт сделал паузу.

Не рекомендуетсяНе рекомендуется использовать эту функцию, и она не существует после 4.0.5.

См. описание "Обслуживание соединений" в главе Возможности.

constant

(PHP 4 >= 4.0.4)

constant - возвращает значение константы.

Описание

mixed constant (string name)

constant() возвратит значение константы, указанной параметром name.

constant() используется, если вам необходимо запросить значение константы, но вам не известно её имя, если, например, она хранится в переменной или возвращается функцией.

convert_cyr_string

(PHP 3>= 3.0.6, PHP 4)

convert_cyr_string - конвертирует один набор символов кириллицы в другой.

Описание

string convert_cyr_string (string str, string from, string to)

Эта функция возвращает данную строку, конвертированную из одного набора символов кириллицы в другой. Аргументы from и to это односимвольные аргументы, представляющие исходный и целевой наборы кириллицы. Поддерживаются типы:

k - koi8-r

w - windows-1251

i - iso8859-5

a - x-cp866

d - x-cp866

m - x-mac-cyrillic

copy

(PHP 3, PHP 4)

copy - копирует файл.

Описание

int copy (string source, string dest)

Делает копию файла. Возвращает TRUE, если копирование удалось, FALSE в ином случае.

cos

(PHP 3, PHP 4)

cos - косинус.

Описание

float cos (float arg)

cos() возвращает косинус параметра arg. Параметр arg задан в радианах.

См. также acos(), sin(), tan() и deg2rad().

cosh

(PHP 4 >= 4.1.0)

cosh - гиперболический косинус.

Описание

float cosh (float arg)

Возвращает гиперболический косинус arg, определённый как (exp(arg) + exp(-arg))/2.

См. также cos(), acosh(), sin() и tan().

count

(PHP 3, PHP 4)

count - считает элементы в переменной.

Описание

int count (mixed var)

Возвращает количество элементов в var, которая обычно является array (поскольку все остальные состоят из одного элемента).

Если var это не массив, будет возвращено 1 (исключение: count(NULL) равно 0).

Предупреждение! count() может возвращать 0 для переменной, которая не установлена, но может также возвращать 0 для переменной, которая была инициализирована пустым массивом. Используйте isset() для проверки того, установлена ли переменная.

Просмотрите раздел Массивы этого учебника, где даны детальные разъяснения того, как массивы реализуются и используются в PHP.

count_chars

(PHP 4)

count_chars - возвращает информацию о символах, используемых в строке.

Описание

mixed count_chars (string string [, int mode])

Подсчитывает количество вхождение каждого байтового значения (0..255) в строке string и возвращает её различными способами. Необязательный параметр Mode имеет по умолчанию значение 0. В зависимости от mode, count_chars() возвращает:

0 - массив с байт-значением в качестве ключа и частотой появления каждого байта в качестве значения.

1 - то же, что 0, но перечисляются только байт-значения с частотой более нуля.

2 - то же, что 0, но перечисляются только байт-значения с частотой, равной нулю.

3 - возвращается строка, содержащая все используемые байт-значения.

4 - возвращается строка, содержащая все неиспользуемые байт-значения.

cpdf_add_annotation

(PHP 3>= 3.0.12, PHP 4)

cpdf_add_annotation - добавляет аннотацию.

Описание

void cpdf_add_annotation (int pdf document, float llx, float lly, float urx, float ury, string title, string content [, int mode])

cpdf_add_annotation() добавляет примечание с нижним левым углом с координатами (llx, lly) и с правым верхним углом с координатами (urx, ury).

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

cpdf_add_outline

(PHP 3>= 3.0.9, PHP 4)

cpdf_add_outline - добавляет закладку/bookmark на текущую страницу.

Описание

void cpdf_add_outline (int pdf document, string text)

Функция cpdf_add_outline() добавляет закладку с текстом text, которая указывает на текущую страницу.

cpdf_arc

(PHP 3>= 3.0.8, PHP 4)

cpdf_arc - прорисовывает дугу.

Описание

void cpdf_arc (int pdf document, float x-coor, float y-coor, float radius, float start, float end [, int mode])

cpdf_arc() прорисовывает дугу с центром в точке (x-coor, y-coor) и радиусом radius, начиная с угла start и заканчивая углом end.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_circle().

cpdf_begin_text

(PHP 3>= 3.0.8, PHP 4)

cpdf_begin_text - начинает текстовый раздел.

Описание

void cpdf_begin_text (int pdf document)

Функция cpdf_begin_text() начинает текстовый раздел. Он обязан заканчиваться функцией cpdf_end_text().

Пример 1. Текстовый вывод
<?php
cpdf_begin_text($pdf);
cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding");
cpdf_text($pdf, 100, 100, "Some text");
cpdf_end_text($pdf)
?>

См. также cpdf_end_text().

cpdf_circle

(PHP 3>= 3.0.8, PHP 4)

cpdf_circle - рисует окружность.

Описание

void cpdf_circle (int pdf document, float x-coor, float y-coor, float radius [, int mode])

Функция cpdf_circle() рисует окружность с центром в точке (x-coor, y-coor) и радиусом radius.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_arc().

cpdf_clip

(PHP 3>= 3.0.8, PHP 4)

cpdf_clip - усекает до текущего пути.

Описание

void cpdf_clip (int pdf document)

Функция cpdf_clip() усекает всю прорисовку до текущего пути/path.

cpdf_close

(PHP 3>= 3.0.8, PHP 4)

cpdf_close - закрывает pdf-документ.

Описание

void cpdf_close (int pdf document)

Функция cpdf_close() закрывает pdf-документ. Это должна быть последняя функция, даже после cpdf_finalize() , cpdf_output_buffer() и cpdf_save_to_file().

См. также cpdf_open().

cpdf_closepath

(PHP 3>= 3.0.8, PHP 4)

cpdf_closepath - закрывает путь.

Описание

void cpdf_closepath (int pdf document)

Функция cpdf_closepath() закрывает текущий путь.

cpdf_closepath_fill_stroke

(PHP 3>= 3.0.8, PHP 4)

cpdf_closepath_fill_stroke - закрывает, заполняет и выравнивает текущий путь.

Описание

void cpdf_closepath_fill_stroke (int pdf document)

Функция cpdf_closepath_fill_stroke() закрывает, заполняет текущий путь текущим цветом заполнения и прорисовывает текущий путь.

См. также cpdf_closepath(), cpdf_stroke(), cpdf_fill(), cpdf_setgray_fill(), cpdf_setgray(), cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_closepath_stroke

(PHP 3>= 3.0.8, PHP 4)

cpdf_closepath_stroke - закрывает путь и прорисовывает линию вокруг пути.

Описание

void cpdf_closepath_stroke (int pdf document)

Функция cpdf_closepath_stroke() это комбинация cpdf_closepath() и cpdf_stroke(). Затем путь очищается.

См. также cpdf_closepath(), cpdf_stroke().

cpdf_continue_text

(PHP 3>= 3.0.8, PHP 4)

cpdf_continue_text - выводит текст на следующей строчке.

Описание

void cpdf_continue_text (int pdf document, string text)

Функция cpdf_continue_text() выводит строку text в следующей строчке.

См. также cpdf_show_xy(), cpdf_text(), cpdf_set_leading(), cpdf_set_text_pos().

cpdf_curveto

(PHP 3>= 3.0.8, PHP 4)

cpdf_curveto - рисует кривую.

Описание

void cpdf_curveto (int pdf document, float x1, float y1, float x2, float y2, float x3, float y3 [, int mode])

Функция cpdf_curveto() прорисовывает кривую Безье от текущей точки до точки (x3, y3) с использованием (x1, y1) и (x2, y2) в качестве контрольных точек.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_moveto(), cpdf_rmoveto(), cpdf_rlineto(), cpdf_lineto().

cpdf_end_text

(PHP 3>= 3.0.8, PHP 4)

cpdf_end_text - заканчивает текстовый раздел.

Описание

void cpdf_end_text (int pdf document)

Функция cpdf_end_text() оканчивает текстовый раздел, который был начат функцией cpdf_begin_text().

Пример 1. Текстовый вывод
<?php
cpdf_begin_text($pdf);
cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding");
cpdf_text($pdf, 100, 100, "Some text");
cpdf_end_text($pdf)
?>

См. также cpdf_begin_text().

cpdf_fill

(PHP 3>= 3.0.8, PHP 4)

cpdf_fill - заполняет текущий путь.

Описание

void cpdf_fill (int pdf document)

Функция cpdf_fill() заполняет внутреннюю часть текущего пути/path текущим цветом.

См. также cpdf_closepath(), cpdf_stroke(), cpdf_setgray_fill(), cpdf_setgray(), cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_fill_stroke

(PHP 3>= 3.0.8, PHP 4)

cpdf_fill_stroke - заполняет и выравнивает текущий путь.

Описание

void cpdf_fill_stroke (int pdf document)

Функция cpdf_fill_stroke() заполняет внутреннюю часть текущего пути текущим цветом и прорисовывает текущий путь.

См. также cpdf_closepath(), cpdf_stroke(), cpdf_fill(), cpdf_setgray_fill(), cpdf_setgray(), cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_finalize

(PHP 3>= 3.0.8, PHP 4)

cpdf_finalize - заканчивает документ.

Описание

void cpdf_finalize (int pdf document)

Функция cpdf_finalize() заканчивает документ. Вы должны по прежнему вызывать cpdf_close().

См. также cpdf_close().

cpdf_finalize_page

(PHP 3>= 3.0.10, PHP 4)

cpdf_finalize_page - заканчивает страницу.

Описание

void cpdf_finalize_page (int pdf document, int page number)

Функция cpdf_finalize_page() заканчивает страницу номером страницы page number.

Эта функция служит только для сохранения памяти. Финализированная страница занимает меньше памяти, но не может быть модифицирована.

См. также cpdf_page_init().

cpdf_global_set_document_limits

(PHP 4)

cpdf_global_set_document_limits - устанавливает границы для любого pdf-документа.

Описание

void cpdf_global_set_document_limits (int maxpages, int maxfonts, int maximages, int maxannotations, int maxobjects)

Функция cpdf_global_set_document_limits() устанавливает различные границы документа. Эта функция должна вызываться перед cpdf_open(), чтобы дать эффект. Она устанавливает границы для любого документа, открытого после этого.

См. также cpdf_open().

cpdf_import_jpeg

(PHP 3>= 3.0.9, PHP 4)

cpdf_import_jpeg - открывает JPEG-изображение.

Описание

int cpdf_import_jpeg (int pdf document, string file name, float x-coor, float y-coor, float angle, float width, float height, float x-scale, float y-scale [, int mode])

Функция cpdf_import_jpeg() открывает изображение, хранимое в файле с именем file name. Формат изображения должен быть jpeg. Изображение помещается на текущей странице в позиции (x-coor, y-coor). Изображение поворачивается на angle градусов.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_place_inline_image().

cpdf_lineto

(PHP 3>= 3.0.8, PHP 4)

cpdf_lineto - рисует линию.

Описание

void cpdf_lineto (int pdf document, float x-coor, float y-coor [, int mode])

Функция cpdf_lineto() рисует линию от текущей точки до точки с координатами (x-coor, y-coor).

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_moveto(), cpdf_rmoveto(), cpdf_curveto().

cpdf_moveto

(PHP 3>= 3.0.8, PHP 4)

cpdf_moveto - устанавливает текущую точку.

Описание

void cpdf_moveto (int pdf document, float x-coor, float y-coor [, int mode])

Функция cpdf_moveto() устанавливает текущую точку с координатами x-coor и y-coor.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

cpdf_newpath

(PHP 3>= 3.0.9, PHP 4)

cpdf_newpath - начинает новый путь.

Описание

void cpdf_newpath (int pdf document)

cpdf_newpath() начинает новый путь в документе, заданном параметром pdf document.

cpdf_open

(PHP 3>= 3.0.8, PHP 4)

cpdf_open - открывает новый pdf-документ.

Описание

int cpdf_open (int compression [, string filename])

Функция cpdf_open() открывает новый pdf-документ. Первый параметр включает сжатие документа, если не равен 0. Второй (необязательный) параметр устанавливает файл, в который документ записывается. Если этот параметр отсутствует, документ создаётся в памяти и может быть записан либо в файл - функцией cpdf_save_to_file(), либо в стандартный вывод - функцией cpdf_output_buffer().

Примечание: return-значение понадобится в последующих версиях ClibPDF как первый параметр во всех других функциях, которые записывают в pdf-документ.

Библиотека ClibPDF принимает filename "-" как синоним stdout. Если PHP скомпилирован как Аpache-модуль, это работать не будет, поскольку способ ClibPDF-вывода в stdout не работает с Аpache. Вы можете решить эту проблему, пропустив filename и использовав cpdf_output_buffer() для вывода pdf-документа.

См. также cpdf_close(), cpdf_output_buffer().

cpdf_output_buffer

(PHP 3>= 3.0.9, PHP 4)

cpdf_output_buffer - выводит pdf-документ в буфер памяти.

Описание

void cpdf_output_buffer (int pdf document)

Функция cpdf_output_buffer() выводит pdf-документ в stdout. Документ, созданный в памяти, как в случае с вызовом cpdf_open(), вызывается без параметра filename.

См. также cpdf_open().

cpdf_page_init

(PHP 3>= 3.0.8, PHP 4)

cpdf_page_init - начинает новую страницу.

Описание

void cpdf_page_init (int pdf document, int page number, int orientation, float height, float width [, float unit])

Функция cpdf_page_init() начинает новую страницу с высотой height и шириной width. Эта страница имеет номер page number и ориентацию orientation.
orientation может быть 0 для portrait и 1 для landscape.
Последний необязательный параметр unit устанавливает единицы измерения для системы координат. Это значение должно быть числом пунктов postscript на unit. Поскольку один дюйм/inch равен 72 пунктам, значение 72 установит unit размером в один дюйм. По умолчанию также 72.

См. также cpdf_set_current_page().

cpdf_place_inline_image

(PHP 3>= 3.0.9, PHP 4)

cpdf_place_inline_image - помещает изображение на страницу.

Описание

void cpdf_place_inline_image (int pdf document, int image, float x-coor, float y-coor, float angle, float width, float height [, int mode])

Функция cpdf_place_inline_image() помещает на страницу изображение, созданное РНР image-функциями, в позиции (x-coor, y-coor). Одновременно это изображение может быть масштабировано.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_import_jpeg().

cpdf_rect

(PHP 3>= 3.0.8, PHP 4)

cpdf_rect - рисует прямоугольник.

Описание

void cpdf_rect (int pdf document, float x-coor, float y-coor, float width, float height [, int mode])

Функция cpdf_rect() рисует прямоугольник с нижним левым углом в точке (x-coor, y-coor). Ширина установлена в width. Высота - в height.

Необязательный параметр mode единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

cpdf_restore

(PHP 3>= 3.0.8, PHP 4)

cpdf_restore - восстанавливает ранее сохранённую среду окружения.

Описание

void cpdf_restore (int pdf document)

Функция cpdf_restore() восстанавливает окружение, сохранённое функцией cpdf_save(). Она работает аналогично postscript-команде grestore. Очень пригодится, если вы захотите перевести или развернуть объект без воздействия на другие объекты.

Пример 1. Save/Restore
<?php
cpdf_save($pdf);
// выполняются все виды поворота, трансформации ...
cpdf_restore($pdf)
?>

См. также cpdf_save().

cpdf_rlineto

(PHP 3>= 3.0.9, PHP 4)

cpdf_rlineto - рисует линию.

Описание

void cpdf_rlineto (int pdf document, float x-coor, float y-coor [, int mode])

Функция cpdf_rlineto() рисует линию из текущей точки в точку с относительными координатами (x-coor, y-coor).

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_moveto(), cpdf_rmoveto(), cpdf_curveto().

cpdf_rmoveto

(PHP 3>= 3.0.9, PHP 4)

cpdf_rmoveto - устанавливает текущую точку.

Описание

void cpdf_rmoveto (int pdf document, float x-coor, float y-coor [, int mode])

Функция cpdf_rmoveto() устанавливает текущую относительную точку с координатами x-coor и y-coor.

Необязательный параметр mode определяет единицы измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_moveto().

cpdf_rotate

(PHP 3>= 3.0.8, PHP 4)

cpdf_rotate - устанавливает поворот.

Описание

void cpdf_rotate (int pdf document, float angle)

Функция cpdf_rotate() устанавливает поворот в градусах на угол angle.

cpdf_rotate_text

(PHP 3>= 3.0.9, PHP 4)

cpdf_rotate_text - устанавливает угол поворота текста.

Описание

void cpdf_rotate_text (int pdfdoc, float angle)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

cpdf_save

(PHP 3>= 3.0.8, PHP 4)

cpdf_save - сохраняет текущее окружение/environment.

Описание

void cpdf_save (int pdf document)

Функция cpdf_save() сохраняет среду текущего окружения. Она работает аналогично postscript-команде gsave. Очень пригодится, если вы захотите перевести или повернуть объект без воздействия на другие объекты.

См. также cpdf_restore().

cpdf_save_to_file

(PHP 3>= 3.0.8, PHP 4)

cpdf_save_to_file - записывает pdf-документ в файл.

Описание

void cpdf_save_to_file (int pdf document, string filename)

Функция cpdf_save_to_file() выводит pdf-документ в файл, если он (документ) создан в памяти.

Эта функция не понадобится, если pdf-документ был открыт путём специфицирования filename как параметра функции cpdf_open().

См. также cpdf_output_buffer(), cpdf_open().

cpdf_scale

(PHP 3>= 3.0.8, PHP 4)

cpdf_scale - устанавливает масштабирование.

Описание

void cpdf_scale (int pdf document, float x-scale, float y-scale)

Функция cpdf_scale() устанавливает фактор масштабирования в обоих направлениях.

cpdf_set_action_url

(PHP 3>= 3.0.9, PHP 4)

cpdf_set_action_url - устанавливает гиперссылку.

Описание

void cpdf_set_action_url (int pdfdoc, float xll, float yll, float xur, float xur, string url [, int mode])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

cpdf_set_char_spacing

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_char_spacing - устанавливает межсимвольное расстояние/character spacing.

Описание

void cpdf_set_char_spacing (int pdf document, float space)

Функция cpdf_set_char_spacing() устанавливает расстояние между символами.

См. также cpdf_set_word_spacing(), cpdf_set_leading().

cpdf_set_creator

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_creator - устанавливает поле creator в pdf-документе.

Описание

void cpdf_set_creator (string creator)

Функция cpdf_set_creator() устанавливает поле creator/автор в pdf-документе.

См. также cpdf_set_subject(), cpdf_set_title(), cpdf_set_keywords().

cpdf_set_current_page

(PHP 3>= 3.0.9, PHP 4)

cpdf_set_current_page - устанавливает текущую страницу.

Описание

void cpdf_set_current_page (int pdf document, int page number)

Функция cpdf_set_current_page() устанавливает текущую страницу, на которой выполняются все операции. Можно переключаться между страницами, пока страница не будет финализирована функцией cpdf_finalize_page().

См. также cpdf_finalize_page().

cpdf_set_font

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_font - выбирает вид и размер текущего шрифта.

Описание

void cpdf_set_font (int pdf document, string font name, float size, string encoding)

Функция cpdf_set_font() устанавливает вид текущего шрифта, размер и кодировку. В настоящее время поддерживаются только стандартные postscript-шрифты.

Последний параметр encoding может принимать следующие значения: "MacRomanEncoding", "MacExpertEncoding", "WinAnsiEncoding" и "NULL".
"NULL" означает встроенную кодировку шрифта.

См. в учебнике ClibPDF Manual информацию о том, как поддерживать азиатские шрифты.

cpdf_set_font_directories

(PHP 4 >= 4.0.6)

cpdf_set_font_directories - устанавливает директории поиска при установке внешних шрифтов.

Описание

void cpdf_set_font_directories (int pdfdoc, string pfmdir, string pfbdir)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

cpdf_set_font_map_file

(PHP 4 >= 4.0.6)

cpdf_set_font_map_file - устанавливает fontname в filename карты переводов при использовании внешних шрифтов.

Описание

void cpdf_set_font_map_file ( int pdfdoc, string filename)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

cpdf_set_horiz_scaling

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_horiz_scaling - устанавливает масштабирование текста по горизонтали.

Описание

void cpdf_set_horiz_scaling (int pdf document, float scale)

Функция cpdf_set_horiz_scaling() устанавливает масштабирование по горизонтали в процентах scale.

cpdf_set_keywords

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_keywords - устанавливает поле keywords pdf-документа.

Описание

void cpdf_set_keywords (string keywords)

Функция cpdf_set_keywords() устанавливает поле keywords pdf-документа.

См. также cpdf_set_title(), cpdf_set_creator(), cpdf_set_subject().

cpdf_set_leading

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_leading - устанавливает расстояние между строчками текста.

Описание

void cpdf_set leading (int pdf document, float distance)

Функция cpdf_set_leading() устанавливает расстояние между строчками текста. Это используется при выводе текста функцией cpdf_continue_text().

См. также cpdf_continue_text().

cpdf_set_page_animation

(PHP 3>= 3.0.9, PHP 4)

cpdf_set_page_animation - устанавливает длительность между страницами.

Описание

void cpdf_set_page_animation (int pdf document, int transition, float duration)

Функция cpdf_set_page_animation() устанавливает время перехода от страницы к странице.

Значением transition может быть:0 - none, 1 - две две линии, проходя по экрану, чередуют страницы 2 - несколько линий, проходя по экрану, чередуют страницы 3 - бокс4 - одна линия, проходя по экрану, чередует страницы 5 - старая страница растворяется, и появляется новая 6 - эффект растворения переходит от одного края экрана к другому 7 - старая страница просто замещается новой (по умолчанию)

Значением duration является количество секунд между сменой страниц.

cpdf_set_subject

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_subject - устанавливает поле subject документа pdf.

Описание

void cpdf_set_subject (string subject)

Функция cpdf_set_subject() устанавливает subject/тему pdf-документа.

См. также cpdf_set_title(), cpdf_set_creator(), cpdf_set_keywords().

cpdf_set_text_matrix

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_text_matrix - устанавливает текстовую матрицу.

Описание

void cpdf_set_text_matrix (int pdf document, array matrix)

Функция cpdf_set_text_matrix() устанавливает матрицу, которая описывает трансформацию, применяемую к текущему шрифту текста.

cpdf_set_text_pos

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_text_pos - устанавливает позицию текста.

Описание

void cpdf_set_text_pos (int pdf document, float x-coor, float y-coor [, int mode])

Функция cpdf_set_text_pos() устанавливает позицию текста для последующего вызова функции cpdf_show().

Необязательный параметр mode это размер единиц измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

См. также cpdf_show(), cpdf_text().

cpdf_set_text_rendering

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_text_rendering - определяет воспроизведение текста.

Описание

void cpdf_set_text_rendering (int pdf document, int mode)

Функция cpdf_set_text_rendering() определяет то, как текст воспроизводится.

Возможными значениями mode являются 0=заполненный текст, 1=перечёркнутый, 2=заполненный и перечёркнутый, 3=невидимый, 4=текст заполнен и добавлен в усекающий путь/clipping path, 5=текст перечёркнут и добавлен в усекающий путь, 6=текст заполнен, перечёркнут и добавлен в усекающий путь, 7=текст добавлен в усекающий путь.

cpdf_set_text_rise

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_text_rise - устанавливает возвышение текста.

Описание

void cpdf_set_text_rise (int pdf document, float value)

Функция cpdf_set_text_rise() устанавливает возвышение текста на value единиц/units.

cpdf_set_title

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_title - устанавливает поле title/заголовка pdf-документа.

Описание

void cpdf_set_title (string title)

Функция cpdf_set_title() устанавливает title -документа.

См. также cpdf_set_subject(), cpdf_set_creator(), cpdf_set_keywords().

cpdf_set_viewer_preferences

(PHP 3>= 3.0.9, PHP 4)

cpdf_set_viewer_preferences - как показывать документ в программе просмотра/viewer.

Описание

void cpdf_set_viewer_preferences (int pdfdoc, array preferences)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

cpdf_set_word_spacing

(PHP 3>= 3.0.8, PHP 4)

cpdf_set_word_spacing - устанавливает расстояние между словами.

Описание

void cpdf_set_word_spacing (int pdf document, float space)

Функция cpdf_set_word_spacing() устанавливает расстояние между словами.

См. также cpdf_set_char_spacing(), cpdf_set_leading().

cpdf_setdash

(PHP 3>= 3.0.8, PHP 4)

cpdf_setdash - устанавливает патэрн из тире.

Описание

void cpdf_setdash (int pdf document, float white, float black)

Функция cpdf_setdash() устанавливает патэрн тире из блоков white и блоков black. Если оба равны 0, устанавливается сплошная линия.

cpdf_setflat

(PHP 3>= 3.0.8, PHP 4)

cpdf_setflat - устанавливает плоскость/flatness.

Описание

void cpdf_setflat (int pdf document, float value)

Функция cpdf_setflat() устанавливает плоскость ("ровность")/flatness в значение от 0 до 100.

cpdf_setgray

(PHP 3>= 3.0.8, PHP 4)

cpdf_setgray - устанавливает цвет прорисовки и заполнения в значение gray.

Описание

void cpdf_setgray (int pdf document, float gray value)

Функция cpdf_setgray() устанавливает текущий цвет прорисовки и заполнения в заданное значение gray.

См. также cpdf_setrgbcolor_stroke(), cpdf_setrgbcolor_fill().

cpdf_setgray_fill

(PHP 3>= 3.0.8, PHP 4)

cpdf_setgray_fill - устанавливает цвет заполнения gray.

Описание

void cpdf_setgray_fill (int pdf document, float value)

Функция cpdf_setgray_fill() устанавливает текущее значение gray для заполнения пути.

См. также cpdf_setrgbcolor_fill().

cpdf_setgray_stroke

(PHP 3>= 3.0.8, PHP 4)

cpdf_setgray_stroke - устанавливает цвет прорисовки gray.

Описание

void cpdf_setgray_stroke (int pdf document, float gray value)

Функция cpdf_setgray_stroke() устанавливает устанавливает текущий цвет прорисовки в значение gray.

См. также cpdf_setrgbcolor_stroke().