pg_fetch_array
(PHP 3>= 3.0.1, PHP 4)
pg_fetch_array - извлекает ряд как массив.
Описание
array pg_fetch_array (resource result, int row [, int result_type])
pg_fetch_array() возвращает массив, соответствующий извлечённому ряду (пары/записи). Возвращает FALSE, если рядов больше нет.
pg_fetch_array() это расширенная версия pg_fetch_row(). В дополнение к хранению данных в числовых индексах (field index) в результирующем массиве, она также хранит данные в ассоциативных индексах (field name) по умолчанию.
row это номер запрашиваемого ряда (записи). Первый ряд 0.
result_type это необязательный параметр, управляющий тем, как инициализируется return-значение.
result_type это константа, которая может принимать следующие значения: PGSQL_ASSOC, PGSQL_NUM
и PGSQL_BOTH.
pg_fetch_array() возвращает ассоциативный массив, имеющий имя поля в качестве ключа с PGSQL_ASSOC,
индекс поля в качестве ключа с PGSQL_NUM и оба name/index поля в качестве ключа с PGSQL_BOTH. По умолчанию PGSQL_BOTH.
Примечание: result_type был введён в PHP 4.0.
pg_fetch_array() НЕСКОЛЬКО медленнее, чем pg_fetch_row(), но значительно проще в использовании.
См. также pg_fetch_row(), pg_fetch_object() и pg_fetch_result().
pg_fetch_object
(PHP 3>= 3.0.1, PHP 4)
pg_fetch_object - извлекает ряд как объект.
Описание
object pg_fetch_object (resource result, int row [, int result_type])
pg_fetch_object() возвращает объект со свойствами, соответствующий извлечённому ряду. Возвращает FALSE, если рядов больше нет или имеется ошибка.
pg_fetch_object() аналогична pg_fetch_array(), с тем только отличием, что возвращается объект, а не массив. Неявно это означает, что вы можете получить доступ к данным только по именам полей, а не по их смещениям (числа являются недопустимыми именами свойств).
row это количество запрашиваемых рядов (записей). Первый ряд 0.
По скорости работы эта функция идентична pg_fetch_array() и почти так же быстра, как pg_fetch_row() (разница незначительна).
Примечание: начиная с 4.3.0, result_type по умолчанию равен PGSQL_ASSOC, а в более старых версиях - PGSQL_BOTH. Числовое свойство не используется, поскольку числовое имя свойства недопустимо в PHP.
result_type может быть удалён в последующих версиях.
См. также pg_query(), pg_fetch_array(), pg_fetch_row() и pg_fetch_result().
pg_fetch_result
(PHP 4 >= 4.2.0)
pg_fetch_result - возвращает значения из ресурса результата.
Описание
mixed pg_fetch_result (resource result, int row, mixed field)
pg_fetch_result() возвращает значения из ресурса result, возвращённого функцией
pg_query().
row это integer.
field это имя поля (string)
или индекс поля (integer). Параметры row и field специфицируют, какую ячейку таблицы результата возвращать. Нумерация рядов
начинается с 0. Вместо именования полей вы можете использовать индекс поля
как незакавыченное число. Индексы полей начинаются с 0.
PostgreSQL имеет много встроенных типов, но здесь поддерживаются только базовые. Все формы типов integer, boolean и void возвращаются как integer-значения. Все формы типов float и real возвращаются как float. Все другие типы, включая массивы, возвращаются как строки, форматированные в той же манере PostgreSQL по умолчанию, которую вы могли видеть в программе psql.
pg_fetch_row
(PHP 3>= 3.0.1, PHP 4)
pg_fetch_row - получает ряд как перечислимый массив.
Описание
array pg_fetch_row (resource result, int row)
pg_fetch_row() извлекает один ряд данных из результата, ассоциированного со специфицированным result ресурсом. Ряд (запись) возвращается как массив. Каждый результирующий столбец хранится в смещении массива, начиная со смещения 0.
Возвращает массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.
См. также pg_query(), pg_fetch_array(), pg_fetch_object() и pg_fetch_result().
pg_field_is_null
(PHP 4 >= 4.2.0)
pg_field_is_null - проверяет, является ли поле NULL.
Описание
int pg_field_is_null (resource result, int row, mixed field)
pg_field_is_null() проверяет является поле NULL или нет. Возвращает 1, если поле в данном ряду NULL. Возвращает 0, если поле в данном ряду НЕ NULL. Поля могут специфицироваться как индекс столбца (число) или имя поля (строка). Номера рядов начинаются с 0.
Примечание: эта функция вызывалась pg_fieldisnull().
pg_field_name
(PHP 4 >= 4.2.0)
pg_field_name - возвращает имя поля.
Описание
string pg_field_name (resource result, int field_number)
pg_field_name() возвращает имя поля, занимающего данный field_number в данном PostgreSQL result ресурсе. Номера полей начинаются с 0.
Примечание: эта функция вызывалась pg_fieldname().
См. также pg_field_num().
pg_field_num
(PHP 4 >= 4.2.0)
pg_field_num - возвращает номер именованного поля.
Описание
int pg_field_num (resource result, string field_name)
pg_field_num() возвращает номер слота столбца (поля) field_name в данном PostgreSQL result ресурсе. Номера полей начинаются с 0. Эта функция возвращает -1 при ошибке.
Примечание: эта функция вызывалась pg_fieldnum().
См. также pg_field_name().
pg_field_prtlen
(PHP 4 >= 4.2.0)
pg_field_prtlen - возвращает напечатанную длину.
Описание
int pg_field_prtlen (resource result, int row_number, string field_name)
pg_field_prtlen() возвращает реальный напечатанный размер (количество символов) специфического значения PostgreSQL result. Номера рядов начинаются с 0. Эта функция возвращает -1 при ошибке.
Примечание: эта функция вызывалась pg_field_prtlen().
См. также pg_field_size().
pg_field_size
(PHP 4 >= 4.2.0)
pg_field_size - возвращает внутренний хранимый размер именованного поля.
Описание
int pg_field_size (resource result, int field_number)
pg_field_size() возвращает внутренний хранимый размер (в байтах) номера поля в данном PostgreSQL result. Номера полей начинаются с 0. Размер поля -1 указывает на переменный размер поля. Эта функция возвращает FALSE при ошибке.
Примечание: эта функция вызывалась pg_fieldsize().
См. также pg_field_len() и pg_field_type().
pg_field_type
(PHP 4 >= 4.2.0)
pg_field_type - возвращает имя типа для соответствующего номера поля.
Описание
string pg_field_type (resource result, int field_number)
pg_field_type() возвращает строку, содержащую имя типа данного field_number в данном PostgreSQL result ресурсе. Номера полей начинаются с 0.
Примечание: эта функция вызывалась pg_fieldtype().
См. также pg_field_len() и pg_field_name().
pg_free_result
(PHP 4 >= 4.2.0)
pg_free_result - освобождает результирующую память.
Описание
bool pg_free_result (resource result)
pg_free_result() должна вызываться только в том случае, если вас беспокоит слишком большой расход памяти при работе вашего скрипта. Вся результирующая память будет автоматически освобождена при окончании работы скрипта. Но, если вы уверены, что результирующие данные вам больше не нужны в скрипте, вы можете вызвать pg_free_result() с ресурсом result в качестве аргумента, и ассоциированная результирующая память будет освобождена. Возвращает true при успехе, false, если возникла ошибка.
Примечание: эта функция вызывалась pg_freeresult().
См. также pg_query().
pg_get_result
(PHP 4 >= 4.2.0)
pg_get_result - получает результат асинхронного запроса.
Описание
resource pg_get_result ([resource connection])
pg_get_result() получает ресурс результата async-запроса, выполненного функцией pg_send_query(). pg_send_query() может отправлять несколько запросов PostgreSQL-серверу, а pg_get_result() используется для получения результатов запросов одного за другим. Возвращает результирующий ресурс. Если результатов больше нет, возвращает FALSE.
pg_host
(PHP 3, PHP 4)
pg_host - возвращает имя хоста, ассоциированное с соединением.
Описание
string pg_host (resource connection)
pg_host() возвращает имя хоста ресурса PostgreSQL-соединения connection, с которым ресурс соединён.
См. также pg_connect() и pg_pconnect().
pg_insert
(только PHP 4 CVS)
pg_insert - вставляет массив в таблицу.
Описание
bool pg_insert (resource connection, string table_name, array assoc_array [, int options])
pg_insert() вставляет assoc_array, имеющий field=>value, в таблицу table_name. Если options специфицирован, pg_convert() применяется к assoc_array со специфицированной опцией.
pg_last_error
(PHP 4 >= 4.2.0)
pg_last_error - получает строку последнего сообщения об ошибке в соединении.
Описание
string pg_last_error (resource connection)
pg_last_error() возвращает последнее сообщение об ошибке для данного connection.
Сообщения об ошибке могут быть переписаны вызовами внутренних PostgreSQL(libpq)-функций. Она может не возвратить соответствующее сообщение об ошибке, если несколько ошибок возникли внутри PostgreSQL-модуля.
Используйте pg_result_error(), pg_result_status() и pg_connection_status() для более качественной обработки ошибок.
Примечание: эта функция вызывалась pg_errormessage().
См. также pg_result_error().
pg_last_notice
(PHP 4 >= 4.0.6)
pg_last_notice - возвращает последнее уведомление от PostgreSQL-сервера.
Описание
string pg_last_notice (resource connection)
pg_last_notice() возвращает последнее уведомление от PostgreSQL-сервера, специфицированного параметром connection. PostgreSQL-сервер отправляет уведомляющие сообщения в различных ситуациях, например, если транзакция не может быть продолжена. С помощью pg_last_notice() вы можете исключить появление бесполезных запросов, проверяя, относится уведомление к данной транзакции, или нет.
Эта функция полностью реализована в PHP 4.3.0. PHP до PHP 4.3.0 игнорирует параметр соединения с БД.
Заметьте, что отслеживание сообщений можно сделать необязательным путём установки 1 для pgsql.ignore_notice ini из PHP 4.3.0.
Логинг уведомлений можно сделать необязательным, установив 0 для pgsql.log_notice ini из PHP 4.3.0. Если pgsql.ignore_notice не установлен 0, уведомление не может быть log-ировано.
См. также pg_query() и pg_last_error().
pg_last_oid
(PHP 4 >= 4.2.0)
pg_last_oid - возвращает oid последнего объекта.
Описание
int pg_last_oid (resource result)
pg_last_oid() используется для запрашивания oid, присвоенного вставляемой паре (записи), если ресурс результата используется из последней команды, отправленной с помощью pg_query(), которая была SQL INSERT. Возвращает положительное integer, если имеется правильный oid. Возвращает FALSE, если возникла ошибка или если команда, отправленная через pg_query(), не была командой INSERT, либо если INSERT потерпела неудачу.
Поле OID стало необязательным полем, начиная с PostgreSQL 7.2. Если поле OID не определено в таблице, программист обязан использовать pg_result_status() для проверки успешности вставки записи.
Примечание: эта функция вызывалась pg_getlastoid().
См. также pg_query() и pg_result_status().
pg_lo_close
(PHP 4 >= 4.2.0)
pg_lo_close - закрывает большой объект/large object.
Описание
bool pg_lo_close (resource large_object)
pg_lo_close() закрывает Large Object. large_object это ресурс большого объекта из pg_lo_open().
Для использования интерфейса большого объекта (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_loclose().
См. также pg_lo_open(), pg_lo_create() и pg_lo_import().
pg_lo_create
(PHP 4 >= 4.2.0)
pg_lo_create - создаёт большой объект/large object.
Описание
int pg_lo_create (resource connection)
pg_lo_create() создаёт Large Object и возвращает
oid этого большого объекта.
connection специфицирует правильное соединение с БД, открытое функцией
pg_connect() или pg_pconnect(). Режимы доступа PostgreSQL
INV_READ, INV_WRITE и INV_ARCHIVE не поддерживаются, объект создаётся всегда с доступом для чтения и записи. INV_ARCHIVE удалён из PostgreSQL
(версии 6.3 и выше). Возвращает large object oid. Возвращает FALSE, если возникла ошибка.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_locreate().
pg_lo_export
(PHP 4 >= 4.2.0)
pg_lo_export - экспортирует large object в файл.
Описание
bool pg_lo_export (int oid, string pathname [, resource connection])
Аргумент oid специфицирует oid большого объекта для экспорта, а аргумент pathname специфицирует pathname файла. Возвращает FALSE, если возникла ошибка, TRUE - в ином случае.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_loexport().
См. также pg_lo_import().
pg_lo_import
(PHP 4 >= 4.2.0)
pg_lo_import - импортирует large object из файла.
Описание
int pg_lo_import (string pathname [, resource connection])
Аргумент pathname специфицирует pathname файла, импортируемого как large object. Возвращает FALSE, если возникла ошибка, oid только что созданного large object - в ином случае.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: если safe mode включён, PHP проверяет, имеют ли файл(ы)/директории, с которыми вы собираетесь работать, тот же UID, что и выполняемый скрипт.
Примечание: эта функция вызывалась pg_loimport().
См. также pg_lo_export() и pg_lo_open().
pg_lo_open
(PHP 4 >= 4.2.0)
pg_lo_open - открывает large object.
Описание
resource pg_lo_open (resource connection, int oid, string mode)
pg_lo_open() открывает Large Object и возвращает ресурс большого объекта. Ресурс инкапсулирует информацию о
соединении.
oid специфицирует правильный oid большого объекта, а mode может быть: "r", "w" или "rw". Возвращает
FALSE, если имеется ошибка.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_loopen().
См. также pg_lo_close() и pg_lo_create().
pg_lo_read
(PHP 4 >= 4.2.0)
pg_lo_read - читает большой объект/large object.
Описание
string pg_lo_read (resource large_object, int len)
pg_lo_read() читает максимум len байт из large object и возвращает его как строку.
large_object специфицирует правильный ресурс большого объекта , а len специфицирует максимальный размер сегмента большого объекта. Возвращает
FALSE, если имеется ошибка.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_loread().
См. также pg_lo_read_all().
pg_lo_read_all
(PHP 4 >= 4.2.0)
pg_lo_read_all - читает весь большой объект/large object и высылает его в браузер.
Описание
int pg_lo_read_all (resource large_object)
pg_lo_read_all() читает large object и передаёт его прямо в браузер после отправки всех шапок/headers. В основном предназначена для отправки двоичных данных вроде изображений или звуков. Возвращает количество прочитанных байтов. Возвращает FALSE, если возникла ошибка.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_loreadall().
См. также pg_lo_read().
pg_lo_seek
(PHP 4 >= 4.2.0)
pg_lo_seek - ищет позицию большого объекта/large object.
Описание
bool pg_lo_seek (resource large_object, int offset [, int whence])
pg_lo_seek() ищет позицию ресурса большого объекта.
whence это PGSQL_SEEK_SET,
PGSQL_SEEK_CUR или PGSQL_SEEK_END.
См. также pg_lo_tell().
pg_lo_tell
(PHP 4 >= 4.2.0)
pg_lo_tell - возвращает текущую позицию большого объекта/large object.
Описание
int pg_lo_tell (resource large_object)
pg_lo_tell() возвращает текущую позицию (смещение от начала большого объекта).
См. также pg_lo_seek().
pg_lo_unlink
(PHP 4 >= 4.2.0)
pg_lo_unlink - удаляет большой объект/large object.
Описание
bool pg_lo_unlink (resource connection, int oid)
pg_lo_unlink() удаляет large object с oid. Возвращает TRUE при успехе, иначе возвращает FALSE.
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_lo_unlink().
См. также pg_lo_create() и pg_lo_import().
pg_lo_write
(PHP 4 >= 4.2.0)
pg_lo_write - записывает в large object.
Описание
int pg_lo_write (resource large_object, string data)
pg_lo_write() записывает в large object из переменной data и возвращает количество реально записанных байт,
FALSE - в случае ошибки.
large_object это ресурс большого объекта из
pg_lo_open().
Для использования интерфейса large object (lo) необходимо заключить его в блок транзакции.
Примечание: эта функция вызывалась pg_lo_write().
См. также pg_lo_create() и pg_lo_open().
pg_metadata
(только PHP 4 CVS)
pg_metadata - получает метаданные таблицы.
Описание
array pg_metadata (resource connection, string table_name)
pg_metadata() возвращает определение таблицы table_name как массив. Если имеется ошибка, возвращает FALSE.
Примечание: эта функция является экспериментальной.
См. также pg_convert().
pg_num_fields
(PHP 4 >= 4.2.0)
pg_num_fields - возвращает количество полей.
Описание
int pg_num_fields (resource result)
pg_num_fields() возвращает количество полей (столбцов) в PostgreSQL result. Этот аргумент является ресурсом результата, возвращённым из pg_query(). Эта функция возвратит -1 при ошибке.
Примечание: эта функция вызывалась pg_numfields().
См. также pg_num_rows() и pg_affected_rows().
pg_num_rows
(PHP 4 >= 4.2.0)
pg_num_rows - возвращает количество рядов.
Описание
int pg_num_rows (resource result)
pg_num_rows() возвращает количество рядов в PostgreSQL result-ресурсе.
result это ресур результата выполнения запроса, возвращённый из pg_query(). Эта функция возвращает -1 при ошибке.
Примечание: используйте pg_affected_rows() для получения количества рядов, задействованных в запросе INSERT, UPDATE и DELETE.
Примечание: эта функция вызывалась pg_numrows().
См. также pg_num_fields() и pg_affected_rows().
pg_options
(PHP 3, PHP 4)
pg_options - получает опции, ассоциированные с соединением.
Описание
string pg_options (resource connection)
pg_options() возвращает строку, содержащую опции, специфицированные в данном PostgreSQL connection-ресурсе.
pg_pconnect
(PHP 3, PHP 4)
pg_pconnect - открывает постоянное PostgreSQL-соединение.
Описание
int pg_pconnect (string connection_string)
pg_pconnect() открывает соединение с БД PostgreSQL. Возвращает ресурс соединения, необходимый для работы других функций PostgreSQL.
Описание параметра connection_string см. в pg_connect().
Для создания постоянного соединения директива pgsql.allow_persistent в php.ini обязана быть установлена "On" (это значение по умолчанию). Максимальное количество постоянных соединений можно определить директивой pgsql.max_persistent в php.ini (по умолчанию -1, т.е. ограничения нет). общее количество соединений может быть установлено директивой pgsql.max_links в php.ini.
pg_close() не закроет постоянные ссылки, сгенерированные функцией pg_pconnect().
См. также pg_connect().
pg_port
(PHP 3, PHP 4)
pg_port - возвращает номер порта, ассоциированный с данным соединением.
Описание
int pg_port (resource connection)
pg_port() возвращает номер порта, по которому соединён данный PostgreSQL connection-ресурс.
pg_put_line
(PHP 4 >= 4.0.3)
pg_put_line - отправляет NULL-законченную строку в PostgreSQL backend.
Описание
bool pg_put_line ([resource connection, string data])
pg_put_line() отправляет NULL-законченную строку в PostgreSQL backend-сервер. Это используется, к примеру, для высокоскоростной вставки данных в таблицу, инициированную началом PostgreSQL copy-операции. Этот заключительный NULL-символ добавляется автоматически. Возвращает TRUE при успехе, FALSE при неудаче.
Примечание: приложение обязано явным образом отправлять два символа "\." в последней строчке для для указания в backend, что оно закончило отправку данных.
См. также pg_end_copy().
pg_query
(PHP 4 >= 4.2.0)
Описание
resource pg_query (resource connection, string query)
pg_query() возвращает результирующий ресурс запроса, если запрос может быть выполнен. Возвращает FALSE при неудаче или если соединение не является правильным. Детали ошибки можно запросить с помощью функции pg_last_error(), если соединение является правильным. pg_last_error() отправляет SQL-оператор в БД PostgreSQL, специфицированную connection-ресурсом. connection обязано быть правильным соединением, возвращённым из pg_connect() или pg_pconnect(). return-значение этой функции это результирующий ресурс запроса, используемый для доступа к результатам из других PostgreSQL-функций, таких как pg_fetch_array().
Примечание: connection это необязательный параметр для pg_query(). Если connection не установлен, используется соединение по умолчанию. Соединение по умолчанию это соединение, созданное функцией pg_connect() или pg_pconnect().
Хотя connection может быть опущен, это не рекомендуется, так как могут быть трудности с поиском багов в скрипте.
Примечание: эта функция вызывалась pg_exec().
pg_exec() всё ещё доступна из соображений совместимости, но советуем использовать новое имя.
См. также pg_connect(), pg_pconnect(), pg_fetch_array(), pg_fetch_object(), pg_num_rows() и pg_affected_rows().
pg_result_error
(PHP 4 >= 4.2.0)
pg_result_error - получает сообщение об ошибке, ассоциированное с результатом.
Описание
string pg_result_error (resource result)
pg_result_error() возвращает сообщение об ошибке, ассоциированное с result-ресурсом. Следовательно, пользователь имеет хороший шанс получить более качественное сообщение об ошибке, чем из pg_last_error().
См. также pg_query(), pg_send_query(), pg_get_result(), pg_last_error() и pg_last_notice().
pg_result_status
(PHP 4 >= 4.2.0)
pg_result_status - получает статус результата запроса.
Описание
int pg_result_status (resource result)
pg_result_status() возвращает статус результирующего ресурса. Возможные retun-значения: PGSQL_EMPTY_QUERY, PGSQL_COMMAND_OK, PGSQL_TUPLES_OK, PGSQL_COPY_TO, PGSQL_COPY_FROM, PGSQL_BAD_RESPONSE, PGSQL_NONFATAL_ERROR и PGSQL_FATAL_ERROR.
См. также pg_connection_status().
pg_select
(только PHP 4 CVS)
Описание
array pg_select (resource connection, string table_name, array assoc_array [, int options])
pg_select() выбирает записи, специфицированные в массиве assoc_array, имеющем field=>value. Для успешного запроса функция возвращает массив, содержащий все записи и поля, соответствующие условию, специфицированному параметром assoc_array. Если options специфицирован, pg_convert() применяется к assoc_array со специфицированной опцией.
pg_send_query
(PHP 4 >= 4.2.0)
pg_send_query - отправляет асинхронный запрос.
Описание
bool pg_send_query (resource connection, string query)
bool pg_send_query (string query)
pg_send_query() отправляет асинхронный запрос соединению connection. В отличие от pg_query(), она может отправлять множественный запрос в PostgreSQL и получать результаты один за другим, используя pg_get_result(). Выполнение скрипта не блокируется при выполнении запроса. Используйте pg_connection_busy() для проверки занятости соединения (т.е. запрос выполняется). Запрос может быть отменён вызовом pg_cancel_query().
В то же время пользователь может отправлять множественный запрос за один раз. Пользователь не может отправлять множественный запрос по занятому соединению. Если запрос отправляется, когда соединение занято, он ожидает, пока последний запрос не закончится и не отбросит все результаты.
См. также pg_query(), pg_cancel_query(), pg_get_result() и pg_connection_busy().
pg_set_client_encoding
(только PHP 3 CVS, PHP 4 >= 4.0.3)
pg_set_client_encoding - устанавливает клиентскую кодировку.
Описание
int pg_set_client_encoding ([resource connection, string encoding])
pg_set_client_encoding() устанавливает клиентскую кодировку и возвращает 0 при успехе, -1 при ошибке.
encoding это клиентская кодировка: SQL_ASCII, EUC_JP, EUC_CN, EUC_KR, EUC_TW, UNICODE, MULE_INTERNAL, LATINX (X=1...9), KOI8, WIN, ALT, SJIS, BIG5, WIN1250. Доступные кодировки зависят от версий ваших PostgreSQL и libpq. В учебнике PostgreSQL имеется информация о поддерживаемых кодировках.
Примечание: эта функция требует PHP-4.0.3 или выше и PostgreSQL-7.0 или выше. Поддерживаемые кодировки зависят от версии PostgreSQL. См. детали в учебнике PostgreSQL.
Функция вызывалась pg_setclientencoding().
См. также pg_client_encoding().
pg_trace
(PHP 4 >= 4.0.1)
pg_trace - включает трассировку PostgreSQL-соединения.
Описание
bool pg_trace (string pathname [, string mode [, resource connection]])
pg_trace() включает отслеживание соединения PostgreSQL frontend/backend с отлаживаемым файлом pathname. Для полного понимания результатов необходимо знать внутренности PostgreSQL протокола сообщения. Для тех, кто этого не знает, она, тем не менее, пригодится для отслеживания ошибок в запросах, отправленных на сервер; вы можете, например, grep '^To backend' trace.log и просмотреть, какой запрос действительно был отправлен на сервер PostgreSQL. Дополнительно см. учебник PostgreSQL.
Filename и mode те же самые, что и в fopen() (mode по умолчанию 'w'), connection специфицирует соединение для трассировки, по умолчанию это последнее открытое соединение.
Возвращает TRUE, если pathname может быть открыт для логинга, FALSE в ином случае.
См. также fopen() и pg_untrace().
pg_tty
(PHP 3, PHP 4)
pg_tty - возвращает tty-имя, ассоциированное с соединением.
Описание
string pg_tty (resource connection)
pg_tty() возвращает tty-имя, которое отправил вывод серверной отладки в данном PostgreSQL connection-ресурсе.
pg_untrace
(PHP 4 >= 4.0.1)
pg_untrace - отключает трассировку PostgreSQL-соединения.
Описание
bool pg_untrace ([resource connection])
Останавливает трассировку, начатую функцией pg_trace(). connection специфицирует соединение, которое отслеживалось и является по умолчанию последним открытым соединением.
Всегда возвращает TRUE.
См. также pg_trace().
pg_update
(только PHP 4 CVS)
pg_update - обновляет таблицу.
Описание
long pg_update (resource connection, string table_name, array condition, array data [, int options])
pg_update() обновляет записи, соответствующие условию condition, данными data. Если options специфицирован, pg_convert() применяется к assoc_array со специфицированными опциями.
php_logo_guid
(PHP 4)
php_logo_guid - получает logo guid.
Описание
string php_logo_guid (void)
Примечание: эта функциональность была добавлена в PHP 4.0.0.
См. также phpinfo(), phpversion() и phpcredits().
php_sapi_name
(PHP 4 >= 4.0.1)
php_sapi_name - возвращает тип интерфейса между web-сервером и PHP.
Описание
string php_sapi_name (void)
php_sapi_name() возвращает строку с нижнем регистре, которая описывает тип интерфейса между web-сервером и PHP (Server API, SAPI). В CGI PHP это строка "cgi", в mod_php для Apache это строка "apache" и так далее.
php_uname
(PHP 4 >= 4.0.2)
php_uname - возвращает информацию об ОС, на которой РНР был построен.
Описание
string php_uname (void)
php_uname() возвращает строку с описанием ОС, на которой PHP построен.
phpcredits
(PHP 4)
phpcredits - печатает кредиты для PHP.
Описание
void phpcredits ([int flag])
Эта функция печатает список кредитов разработчиков, модулей etc. Она генерирует соответствующие HTML-коды для вставки информации на страницу. flag является необязательным и по умолчанию имеет значение CREDITS_ALL. Для генерации специализированной страницы кредитов вы можете использовать параметр flag. Например, для печати основных кредитов вы используете в вашем коде что-нибудь такое:
... phpcredits(CREDITS_GENERAL); ...
Если вы хотите напечатать разработчиков ядра и группу документации, вы используете:
phpinfo
(PHP 3, PHP 4)
phpinfo - выводит много информации о PHP.
Описание
int phpinfo ([int what])
Выводит большое количество информации о текущем статусе PHP. Сюда входит информация об опциях компиляции PHP и о расширениях, версии PHP, информация сервера и окружения (если скомпилирован как модуль), окружение PHP, версия ОС, пути, master и локальные переменные опций конфигурации, шапки HTTP и PHP License.
Поскольку каждая система настроена по-своему, phpinfo() обычно используется для проверки установок конфигурации и доступности предопределённых переменных в данной системе. Также phpinfo() является важной отладочной утилитой, так как содержит все данные EGPCS (Environment, GET, POST, Cookie, Server).
Вывод может быть специализирован путём передачи одной или более следующих константных битовых значений, суммированных в необязательном параметре what. Можно также комбинировать соответствующие константны или битовые значения операцией or.
Таблица 1. Опции phpinfo()
phpversion
(PHP 3, PHP 4)
phpversion - получает текущую версию PHP.
Описание
string phpversion (void)
Возвращает строку с версией работающего в данный момент разборщика PHP.
Примечание: эта информация доступна также в предопределённой константе PHP_VERSION.
pi
(PHP 3, PHP 4)
Описание
float pi (void)
Возвращает приблизительное значение pi. Возвращаемое float имеет точность на базе директивы precision в файле php.ini, которая по умолчанию имеет значение 14. Также вы можете использовать константу M_PI, которая даёт результат аналогично pi().
png2wbmp
(PHP 4 >= 4.0.5)
png2wbmp - конвертирует файл PNG-изображения в файл WBMP-изображения.
Описание
int png2wbmp (string pngname, string wbmpname, int d_height, int d_width, int threshold)
Конвертирует pngname PNG-файл в формат WBMP и сохраняет его как wbmpname. С помощью d_height и d_width вы специфицируете высоту и ширину изображения назначения.
Примечание: поддержка WBMP возможно только тогда, когда PHP скомпилирован относительно GD-1.8 или новее.
См. также jpeg2wbmp().
popen
(PHP 3, PHP 4)
popen - открывает файловый указатель процесса.
Описание
int popen (string command, string mode)
Открывает канал к процессу, выполняемому путём разветвления команды, заданной параметром command.
Возвращает файловый указатель, идентичный указателю, возвращаемому функцией fopen(), за исключением того, что он однонаправленный (может использоваться только для чтения или только для записи) и обязан быть закрыт функцией pclose(). Этот указатель может использоваться с fgets(), fgetss() и fputs().
Если возникает ошибка, возвращает FALSE.
pos
(PHP 3, PHP 4)
pos - получает текущий элемент из массива.
Описание
mixed pos (array array)
posix_ctermid
(PHP 3>= 3.0.13, PHP 4)
posix_ctermid - получает имя пути управляющего терминала.
Описание
string posix_ctermid (void)
Нужно дописать.
posix_getcwd
(PHP 3>= 3.0.13, PHP 4)
posix_getcwd - Pathname текущей директории.
Описание
string posix_getcwd (void)
Нужно дописать ASAP.
posix_getegid
(PHP 3>= 3.0.10, PHP 4)
posix_getegid - возвращает действующий group ID текущего процесса.
Описание
int posix_getegid (void)
Возвращает числовой group ID текущего процесса. См. также в posix_getgrgid() информацию о том, как конвертировать это в имя группы.
posix_geteuid
(PHP 3>= 3.0.10, PHP 4)
posix_geteuid - возвращает эффективный user ID текущего процесса.
Описание
int posix_geteuid (void)
Возвращает числовой эффективный user ID текущего процесса. См. также в posix_getpwuid() информацию о том, как конвертировать это значение в пригодное для использования username.
posix_getgid
(PHP 3>= 3.0.10, PHP 4)
posix_getgid - возвращает реальный group ID текущего процесса.
Описание
int posix_getgid (void)
Возвращает числовой real group ID текущего процесса. См. также в posix_getgrgid() информацию о том, как конвертировать это значение в пригодное для использования имя группы.
posix_getgrgid
(PHP 3>= 3.0.13, PHP 4)
posix_getgrgid - возвращает информацию о группе по её group id.
Описание
array posix_getgrgid (int gid)
Нужно дописать.
posix_getgrnam
(PHP 3>= 3.0.13, PHP 4)
posix_getgrnam - возвращает информацию о группе по её имени.
Описание
array posix_getgrnam (string name)
Нужно дописать.
posix_getgroups
(PHP 3>= 3.0.10, PHP 4)
posix_getgroups - возвращает набор групп/group set текущего процесса.
Описание
array posix_getgroups (void)
Возвращает массив целых чисел, содержащий числовые group ids набора групп текущего процесса. См. также в posix_getgrgid() информацию о том, как конвертировать это значение в пригодные для использования имена групп.
posix_getlogin
(PHP 3>= 3.0.13, PHP 4)
posix_getlogin - возвращает login-имя.
Описание
string posix_getlogin (void)
Возвращает login-имя пользователя, владеющего текущим процессом. См. в posix_getpwnam() информацию о том, как получить больше информации об этом пользователе.
posix_getpgid
(PHP 3>= 3.0.10, PHP 4)
posix_getpgid - получает group id процесса для управления работой.
Описание
int posix_getpgid (int pid)
Возвращает идентификатор группы процесса pid.
Это не POSIX-функция, а обычная функция систем BSD System V. Если ваша система не поддерживает эту функцию на системном уровне, данная PHP-функция всегда возвращает FALSE.
posix_getpgrp
(PHP 3>= 3.0.10, PHP 4)
posix_getpgrp - возвращает групповой идентификатор текущего процесса.
Описание
int posix_getpgrp (void)
Возвращает идентификатор группы текущего процесса. См. страницы учебника POSIX.1 getpgrp(2) вашей системы POSIX для получения информации о группах процесса.
posix_getpid
(PHP 3>= 3.0.10, PHP 4)
posix_getpid - возвращает идентификатор текущего процесса.
Описание
int posix_getpid (void)
posix_getppid
(PHP 3>= 3.0.10, PHP 4)
posix_getppid - возвращает идентификатор родительского процесса.
Описание
int posix_getppid (void)
Возвращает идентификатор родительского процесса текущего процесса.
posix_getpwnam
(PHP 3>= 3.0.13, PHP 4)
posix_getpwnam - возвращает информацию о пользователе по его username.
Описание
array posix_getpwnam (string username)
Возвращает ассоциативный массив, содержащий информацию о пользователе, на который имеется ссылка алфавитно-числового username, переданного в параметре username.
Возвращаются следующие элементы массива:
Таблица 1. Массив с информацией о пользователе
posix_getpwuid
(PHP 3>= 3.0.13, PHP 4)
posix_getpwuid - возвращает информацию о пользователе по его user id.
Описание
array posix_getpwuid (int uid)
Возвращает ассоциативный массив, содержащий информацию о пользователе, на которого имеется ссылка через числовой user ID, переданный в параметре uid.
Возвращаются следующие элементы массива:
Таблица 1. Массив информации о пользователе
posix_getrlimit
(PHP 3>= 3.0.10, PHP 4)
posix_getrlimit - возвращает информацию об ограничениях системных ресурсов.
Описание
array posix_getrlimit (void)
Нужно дописать ASAP.
posix_getsid
(PHP 3>= 3.0.10, PHP 4)
posix_getsid - получает текущий sid процесса.
Описание
int posix_getsid (int pid)
Возвращает sid процесса pid. Если pid равен 0, возвращается sid текущего процесса.
Это не POSIX-функция, но она обычна для систем System V. Если ваша система не поддерживает эту функцию на системном уровне, данная PHP-функция будет всегда возвращать FALSE.
posix_getuid
(PHP 3>= 3.0.10, PHP 4)
posix_getuid - возвращает реальный user ID текущего процесса.
Описание
int posix_getuid (void)
Возвращает числовой real user ID текущего процесса. См. также в posix_getpwuid() информацию о то, как конвертировать это значение в пригодное для использования username.
posix_isatty
(PHP 3>= 3.0.13, PHP 4)
posix_isatty - определяет, является ли дескриптор файла интерактивным терминалом.
Описание
bool posix_isatty (int fd)
Нужно дописать.
posix_kill
(PHP 3>= 3.0.13, PHP 4)
posix_kill - отправляет сигнал процессу.
Описание
bool posix_kill (int pid, int sig)
Отправляет сигнал sig процессу с идентификатором pid. Возвращает FALSE, если не может отправить сигнал, иначе TRUE.
См. также учебную страницу kill(2) вашей системы POSIX, на которой содержится дополнительная информация об отрицательных идентификаторах процесса, special pid 0, special pid -1 и сигнале номер 0.
posix_mkfifo
(PHP 3>= 3.0.13, PHP 4)
posix_mkfifo - создаёт специальный fifo-файл (именованный канал/named pipe).
Описание
bool posix_mkfifo (string pathname, int mode)
posix_mkfifo() создаёт специальный FIFO-файл, который существует в файловой системе и работает как конечная точка двунаправленного соединения процессов.
Второй параметр mode должен быть задан в восьмеричной нотации (например, 0644). Допуск вновь созданного FIFO зависит также от установок текущей umask(). Разрешения для созданного файла имеют значения (mode & ~umask).
Примечание: если безопасный режим включён, PHP проверяет, имеет ли директория, в которой вы намереваетесь работать, тот же UID, что и выполняемый скрипт.
posix_setegid
(PHP 4 >= 4.0.2)
posix_setegid - устанавливает эффективный GID текущего процесса.
Описание
bool posix_setegid (int gid)
Устанавливает эффективный group ID текущего процесса. Это привилегированная функция, и вам понадобятся соответствующие права (обычно root) в вашей системе, чтобы выполнять её.
Возвращает TRUE при успехе, иначе FALSE.
posix_seteuid
(PHP 4 >= 4.0.2)
posix_seteuid - устанавливает эффективный UID текущего процесса.
Описание
bool posix_seteuid (int uid)
Устанавливает реальный user ID текущего процесса. Это привилегированная функция, и вам понадобятся соответствующие права (обычно root) в вашей системе, чтобы выполнять её.
Возвращает TRUE при успехе, иначе FALSE. См. также posix_setgid().
posix_setgid
(PHP 3>= 3.0.13, PHP 4)
posix_setgid - устанавливает GID текущего процесса.
Описание
bool posix_setgid (int gid)
Устанавливает реальный group ID текущего процесса. Это привилегированная функция, и вам понадобятся соответствующие права (обычно root) в вашей системе, чтобы выполнять её. Порядок вызова: сначала posix_setgid(), затем posix_setuid().
Возвращает TRUE при успехе, иначе FALSE.
posix_setpgid
(PHP 3>= 3.0.13, PHP 4)
posix_setpgid - устанавливает process group id для управления работой.
Описание
int posix_setpgid (int pid, int pgid)
Даёт возможность процессу pid вступить в группу pgid. См. в POSIX.1 и на странице учебника setsid(2) вашей системы POSIX информацию о группах процесса и управлении работой. Возвращает TRUE при успехе, иначе FALSE.
posix_setsid
(PHP 3>= 3.0.13, PHP 4)
posix_setsid - делает текущий процесс лидером сессии.
Описание
int posix_setsid (void)
Делает текущий процесс лидером сессии. См. в POSIX.1 и на странице учебника setsid(2) вашей системы POSIX информацию о группах процесса и управлении работой. Возвращает session id.
posix_setuid
(PHP 3>= 3.0.13, PHP 4)
posix_setuid - устанавливает UID текущего процесса.
Описание
bool posix_setuid (int uid)
Устанавливает реальный user ID текущего процесса. Это привилегированная функция, и вам понадобятся соответствующие права (обычно root) в вашей системе, чтобы выполнять её.
Возвращает TRUE при успехе, иначе FALSE. См. также posix_setgid().
posix_times
(PHP 3>= 3.0.13, PHP 4)
posix_times - получает время процесса.
Описание
array posix_times (void)
Возвращает хэш строк с информацией об использовании CPU текущим процессом. Индексы хэша это:
ticks - количество тиков, прошедших после перезагрузки.
utime - пользовательское время, использованное текущим процессом.
stime - системное время, использованное текущим процессом.
cutime - пользовательское время, использованное текущим процессом и потомками.
cstime - системное время, использованное текущим процессом и потомками.
posix_ttyname
(PHP 3>= 3.0.13, PHP 4)
posix_ttyname - определяет имя устройства терминала.
Описание
string posix_ttyname (int fd)
Нужно дописать.
posix_uname
(PHP 3>= 3.0.10, PHP 4)
posix_uname - получает системное имя.
Описание
array posix_uname (void)
Возвращает хэш строк с информацией о системе. Индексы хэша это:
sysname - имя ОС (например, Linux)
nodename - системное имя (например, valiant)
release - релиз ОС (например, 2.2.10)
version - версия (например, #4 Tue Jul 20 17:01:36 MEST 1999)
machine - системная архитектура (например, i586)
domainname - DNS имя домена (например, php.net)
domainname это GNU-расширение, а не часть POSIX.1, поэтому это поле доступно только в GNU-системах или при использовании GNU libc.
Posix требует, чтобы вы не брали на себя ответственность за формат значений, например, вы не можете полагаться на номера версий из трёх цифр или ещё что-нибудь, возвращаемое этой функцией.
pow
(PHP 3, PHP 4)
pow - экспоненциальное выражение.
Описание
number pow (number base, number exp)
Возвращает base, возведённую в степень exp. Если возможно, эта функция возвращает integer.
Если возведение в степень не может быть вычислено, выдаётся предупреждение, а pow() возвращает FALSE.
preg_grep
(PHP 4)
preg_grep - возвращает массив вхождений, совпадающих с патэрном.
Описание
array preg_grep (string pattern, array input)
preg_grep() возвращает массив, состоящий из элементов массива input, совпавших с данным pattern.
Начиная с PHP 4.0.4, возвращаемые функцией preg_grep() результаты индексируются с использованием ключей input-массива. Если такое поведение нежелательно, используйте array_values() с массивом, возвращённым функцией preg_grep(), для реиндексации значений.
preg_match
(PHP 3>= 3.0.9, PHP 4)
preg_match - выполняет подстановку регулярного выражения.
Описание
int preg_match (string pattern, string subject [, array matches [, int flags]])
Ищет в subject совпадения с регулярным выражением, заданным в pattern.
Если matches предоставлен, он заполняется результатами поиска. $matches[0] будет содержать текст, совпавший со всем патэрном, $matches[1] будет содержать текст, совпавший первым захваченным субпатэрном в скобках, и так далее.
flags это:
- PREG_OFFSET_CAPTURE
Если этот флаг установлен, для каждого найденного совпадения будет возвращаться сопутствующее строковое смещение. Заметьте, что это изменяет return-значение в массиве, где каждый элемент является массивом, состоящим из совпавшей строки и в смещении 0 и её строковым смещением в subject в смещении 1. Этот флаг доступен, начиная с PHP 4.3.0.
Параметр flags доступен, начиная с PHP 4.3.0.
preg_match() возвращает количество совпадений pattern. Это будет либо 0 раз (нет совпадений), либо 1 раз, поскольку preg_match() остановит поиск после первого найденного совпадения. preg_match_all(), наоборот, продолжит поиск до достижения конца subject. preg_match() возвращает FALSE при возникновении ошибки.
preg_match_all
(PHP 3>= 3.0.9, PHP 4)
preg_match_all - выполняет глобальный поиск совпадения регулярного выражения.
Описание
int preg_match_all (string pattern, string subject, array matches [, int flags])
Ищет в subject все совпадения с регулярным выражением pattern и помещает их в matches в порядке, специфицированном в order.
После нахождения первого совпадения последующий поиск продолжается до нахождения последнего совпадения.
flags может быть комбинацией следующих флагов (обратите внимание, что нет смысла использовать PREG_PATTERN_ORDER вместе с PREG_SET_ORDER):
- PREG_PATTERN_ORDER
Упорядочивает результаты таким образом, что $matches[0] это массив полных совпадений с патэрном, $matches[1] это массив строк, совпавших с первым субпатэрном в скобках, и так далее.
preg_quote
(PHP 3>= 3.0.9, PHP 4)
preg_quote - закавычивает символы регулярного выражения.
Описание
string preg_quote (string str [, string delimiter])
preg_quote() принимает str и помещает backslash перед каждым символом, который является частью синтаксиса регулярного выражения. Это используется в тех случаях, когда у вас имеется строка на этапе прогона, которая должна совпасть с некоторым текстом и может содержать специальные regex-символы.
Если необязательный delimiter специфицирован, он также мнемонизируется/escaped. Это делается для мнемонизации разграничителя/delimiter, которая необходима в PCRE-функциях. Символ / это самый распространённый разграничитель.
Специальные символы регулярного выражения:
preg_replace
(PHP 3>= 3.0.9, PHP 4)
preg_replace - выполняет поиск и замену регулярного выражения.
Описание
mixed preg_replace (mixed pattern, mixed replacement, mixed subject [, int limit])
Ищет в subject совпадения с pattern и замещает их replacement. Если limit специфицирован, то замещаются только limit совпадений; если limit опущен или равен -1, замещаются все совпадения.
Replacement может содержать ссылку в форме \\n или (начиная с PHP 4.0.4) $n, где последняя форма предпочтительнее. Каждая такая ссылка замещается текстом, захваченным n'ным патэрном в скобках. n может быть от 0 до 99, а \\0 или $0 ссылаются на текст, совпавший со всем патэрном. Открывающие скобки подсчитываются слева направо (начиная с 1) для получения количества захватывающих субпатэрнов.
Если совпадения найдены, возвращается новый subject, иначе subject возвращается без изменений.
Каждый параметр preg_replace() может быть массивом.
Если subject это массив, то поиск и замена выполняются в каждом вхождении subject, return-значение также будет массивом.
Если pattern и replacement являются массивами, то preg_replace() принимает значение из каждого массива и использует их для выполнения поиска и замены в subject. Если replacement имеет меньше значений, чем pattern, то для оставшихся значений для замены используется пустая строка. Если pattern это массив, а replacement это строка, то эта замещающая строка используется для каждого значения pattern. Обратное не будет иметь смысла.
Модификатор /e делает так, что preg_replace() рассматривает параметр replacement как PHP-код после выполнения соответствующей замены ссылок.
Подсказка: убедитесь, что replacement образует строку правильного PHP-кода, иначе PHP сообщит об ошибке разбора в строчке с preg_replace().preg_replace_callback
(PHP 4 >= 4.0.5)
preg_replace_callback - выполняет поиск и замену регулярного выражения с использованием callback/обратного вызова.
Описание
mixed preg_replace_callback (mixed pattern, mixed callback, mixed subject [, int limit])
Поведение этой функции почти идентично preg_replace(), но вместо параметра replacement необходимо специфицировать callback, который вызовет и передаст массив совпавших элементов в строке-субъекте. callback должен возвращать строку замещения. Эта функция была введена в PHP 4.0.5.
См. также preg_replace().
preg_split
(PHP 3>= 3.0.9, PHP 4)
preg_split - делить строку регулярным выражением.
Описание
array preg_split (string pattern, string subject [, int limit [, int flags]])
Примечание: параметр flags был введён в PHP 4 Beta 3.
Возвращает массив, содержащий подстроки из subject, разделённого по границам совпадений с pattern.
Если limit специфицирован, то будет возвращены только подстроки до limit, а если limit равен -1, это означает "нет ограничения", что используется для специфицирования flags.
flags может быть комбинацией следующих флагов (с помощью битовой операции |):
- PREG_SPLIT_NO_EMPTY
Если это флаг установлен, только непустые участки возвращаются функцией preg_split().
- PREG_SPLIT_DELIM_CAPTURE
Если это флаг установлен, выражение в скобках в патэрне ограничителя будет захвачено и возвращено. Этот флаг был введён в 4.0.5.
- PREG_SPLIT_OFFSET_CAPTURE
Если это флаг установлен, для каждого найденного совпадения будет также возвращено смещение дополнительной строки. Заметьте, что это изменит return-значение в массиве, где каждый элемент является массивом, состоящим из совпавшей строки в смещении 0 и её строкового смещения в subject - в смещении1. Этот флаг доступен, начиная с PHP 4.3.0.
prev
(PHP 3, PHP 4)
prev - возвращает внутренний указатель массива в начало.
Описание
mixed prev (array array)
Возвращает элемент массива, на который указывает внутренний указатель массива, в предыдущее место, или FALSE, если элементов больше нет.
prev() работает, как next(), но возвращает внутренний указатель массива в определённое место, а не продвигает его вперёд.
См. также current(), end(), next() и reset().
(unknown)
Описание
print (string arg)
Выводит arg. Возвращает TRUE при успехе, FALSE при неудаче.
print() это в действительности не функция (а конструкция языка), поэтому с ней не обязательно использовать скобки. Но print(), в отличие от echo(), может вызываться с использованием функции переменной.
print_r
(PHP 4)
print_r - печатает читабельную информацию о переменной.
Описание
void print_r (mixed expression)
print_r() выводит пригодную для чтения человеком информацию о переменной. Если задано string, integer или float, печатается само значение. Если задан array, значения будут представлены в формате с показом ключей и элементов. Аналогичная нотация используется для object.
Помните, что print_r() перемещает указатель массива в конец. Используйте reset() для возврата его в начало.
Подсказка: как при любом прямом выводе информации в браузер, вы можете использовать функции управления выводом для захвата вывода этой функции и сохранить его - например - в string.
printer_abort
(unknown)
printer_abort - удаляет файл спула принтера.
Описание
void printer_abort (resource handle)
Эта функция удаляет файл спула принтера.
handle обязан быть правильным дескриптором принтера.
printer_close
(unknown)
printer_close - закрывает открытое соединение с принтером.
Описание
void printer_close (resource handle)
Эта функция закрывает соединение с принтером. printer_close() закрывает также контекст активного устройства.
handle обязан быть правильным дескриптором принтера.
Пример 1. printer_close()
$handle = printer_open(); printer_close($handle);
printer_create_brush
(unknown)
printer_create_brush - создаёт новую кисть/brush.
Описание
mixed printer_create_brush (int style, string color)
Функция создаёт новую кисть и возвращает её дескриптор. Кисть используется для заполнения фигур. Пример см. в printer_select_brush(). color обязан быть цветом в 16-ричном формате RGB, т.е. "000000" для black. style обязан быть одной из следующих констант:
PRINTER_BRUSH_SOLID: создаёт кисть со сплошным цветом.
PRINTER_BRUSH_DIAGONAL: создаёт кисть с наклоном в 45 градусов слева направо (/).
PRINTER_BRUSH_CROSS: создаёт кисть - крестовидный штрих ( + ).
PRINTER_BRUSH_DIAGCROSS: создаёт кисть ( x ).
PRINTER_BRUSH_FDIAGONAL: создаёт кисть с наклонов в 45 градусов влево ( \ ).
PRINTER_BRUSH_HORIZONTAL: создаёт кисть - горизонтальный штрих ( - ).
PRINTER_BRUSH_VERTICAL: создаёт кисть - вертикальный штрих ( | ).
PRINTER_BRUSH_CUSTOM: создаёт специальную кисть из BMP-файла. Второй параметр используется для специфицирования BMP вместо кода цвета RGB.
printer_create_dc
(unknown)
printer_create_dc - создаёт новый контекст устройства.
Описание
void printer_create_dc (resource handle)
Функция создаёт новый контекст устройства. Контекст устройства используется для специализации графических объектов документа. handle обязан быть правильным дескриптором принтера.
Пример 1. printer_create_dc()
$handle = printer_open(); printer_start_doc($handle); printer_start_page($handle); printer_create_dc($handle); /* делается некая работа с dc */ printer_set_option($handle, PRINTER_TEXT_COLOR, "333333"); printer_draw_text($handle, 1, 1, "text"); printer_delete_dc($handle); /* создаётся другой dc */ printer_create_dc($handle); printer_set_option($handle, PRINTER_TEXT_COLOR, "000000"); printer_draw_text($handle, 1, 1, "text"); /* некая работа с dc */ printer_delete_dc($handle); printer_endpage($handle); printer_end_doc($handle); printer_close($handle);
