dbplus_getlock

(только 4.1.0 - 4.2.1)

dbplus_getlock - получает блокировку записи в паре/tuple.

Описание

int dbplus_getlock (resource relation, string tname)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

dbplus_getlock() запрашивает блокировку записи для специфицированной tuple. Возвращает нуль при успехе или ненулевое значение кода ошибки, особенно DBPLUS_ERR_WLOCKED, при неудаче.

См. также dbplus_freelock(), dbplus_freerlocks() и dbplus_freealllocks().

dbplus_getunique

(только 4.1.0 - 4.2.1)

dbplus_getunique - получает уникальное id-число для связи/relation.

Описание

int dbplus_getunique (resource relation, int uniqueid)

dbplus_getunique() получает число, гарантированно уникальное для данной relation, и передаёт его обратно в переменной, заданной как uniqueid.

Эта функция возвратит нуль (aka. DBPLUS_ERR_NOERR) при успехе или код ошибки db++ при неудаче. См. в dbplus_errcode() или во введении к этой главе информацию о кодах ошибок db++.

dbplus_info

(только 4.1.0 - 4.2.1)

dbplus_info - ???

Описание

int dbplus_info (resource relation, string key, array )

Реализации ещё нет.

dbplus_last

(только 4.1.0 - 4.2.1)

dbplus_last - получает последнюю пару/tuple из связи/relation.

Описание

int dbplus_last (resource relation, array tuple)

dbplus_curr() читает данные последней tuple для данной relation, делает её текущей tuple и передаёт её обратно в tuple как ассоциативный массив.

Эта функция возвращает нуль (aka. DBPLUS_ERR_NOERR) при успехе или код ошибки db++ при неудаче. См. в dbplus_errcode() или во введении к этой главе информацию о кодах ошибок db++.

См. также dbplus_first(), dbplus_curr(), dbplus_prev() и dbplus_next().

dbplus_lockrel

(unknown)

dbplus_lockrel - запрашивает блокировку от записи для связи/relation.

Описание

int dbplus_lockrel (resource relation)

dbplus_lockrel() запрашивает блокировку от записи для данной relation. Другие клиенты могут продолжать запрашивать эту relation, но не смогут её изменять, пока блокировка существует.

dbplus_next

(только 4.1.0 - 4.2.1)

dbplus_next - получает следующую пару/tuple из связи/relation.

Описание

int dbplus_next (resource relation, array)

dbplus_curr() читает данные следующей tuple для данной relation, делает её текущей tuple и передаёт обратно в tuple как ассоциативный массив.

См. также dbplus_first(), dbplus_curr(), dbplus_prev() и dbplus_last().

dbplus_open

(только 4.1.0 - 4.2.1)

dbplus_open - открывает реляционный файл.

Описание

resource dbplus_open (string name)

Реляционный файл name будет открыт.name это может быть имя файла или имя относительного или абсолютного пути. Он будет отображён в любом случае в абсолютный путь к файлу на специфической хост-машине и сервере.

При успехе возвращается ресурс реляционного файла (курсор), который обязан быть использован в любой последующей команде, относящейся к связи/relation. Неудача даёт нулевое return-значение, реальный код ошибки может быть запрошен с помощью вызова функции dbplus_errno().

dbplus_prev

(только 4.1.0 - 4.2.1)

dbplus_prev - получает предыдущую пару/tuple из связи/relation.

Описание

int dbplus_prev (resource relation, array tuple)

dbplus_curr() читает данные следующей tuple для данной relation, делает эту tuple текущей и передаёт её обратно в tuple как ассоциативный массив.

См. также dbplus_first(), dbplus_curr(), dbplus_next() и dbplus_last().

dbplus_rchperm

(только 4.1.0 - 4.2.1)

dbplus_rchperm - изменяет реляционный допуск.

Описание

int dbplus_rchperm (resource relation, int mask, string user, string group)

dbplus_rchperm() изменяет разрешение на доступ, как специфицировано mask, user и group. Значения этих позиций специфичны для операционной системы.

dbplus_rcreate

(только 4.1.0 - 4.2.1)

dbplus_rcreate - создаёт новую связь (реляцию) DB++.

Описание

resource dbplus_rcreate (string name, mixed domlist [, boolean overwrite])

dbplus_rcreate() создаёт новую связь (реляцию)/relation name. Существующая relation с тем же именем будет перезаписана только тогда, когда эта связь в данный момент не используется и overwrite установлен в TRUE.

domlist должен содержать спецификацию домена для новой relation в массиве строк-описаний домена. ( dbplus_rcreate() принимает также строку со строками-описаниями домена, разделёнными пробелами, но рекомендуется использовать массив). Строка-описание домена состоит из имени домена, уникального в данной relation, слэша (/) и символа спецификации типа. См. в документации db++, особенно в dbcreate(1) manpage, описание допустимых спецификаторов типа и их значение.

dbplus_rcrtexact

(только 4.1.0 - 4.2.1)

dbplus_rcrtexact - создаёт точную, но пустую, копию связи/relation, включая индексы.

Описание

resource dbplus_rcrtexact (string name, resource relation, boolean overwrite)

dbplus_rcrtexact() создаёт точную, но пустую, копию данной relation под новым именем name. Существующая relation с тем же name будет перезаписана только в том случае, если overwrite имеет значение TRUE и никакой другой процесс не использует эту relation в данный момент.

dbplus_rcrtlike

(только 4.1.0 - 4.2.1)

dbplus_rcrtlike - создаёт пустую копию связи/relation с индексами по умолчанию.

Описание

resource dbplus_rcrtlike (string name, resource relation, int flag)

dbplus_resolve

(только 4.1.0 - 4.2.1)

dbplus_resolve - разрешает хост информацию для связи/relation.

Описание

int dbplus_resolve (string relation_name)

dbplus_resolve() пытается разрешить/resolve данное имя relation_name и определить id сервера, реальное hostname и путь к БД на данном хосте. Эта функция возвращает массив, содержащий эти значения под ключами 'sid', 'host' и 'host_path' или FALSE при ошибке.

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

dbplus_restorepos

(только 4.1.0 - 4.2.1)

dbplus_restorepos - ???

Описание

int dbplus_restorepos (resource relation, array tuple)

Реализации ещё нет.

dbplus_rkeys

(только 4.1.0 - 4.2.1)

dbplus_rkeys - специфицирует новый primary key для relation.

Описание

resource dbplus_rkeys (resource relation, mixed domlist)

dbplus_rkeys() замещает текущий primary key для relation комбинацией доменов, специфицированной списком domlist.

domlist может передаваться как строка с отдельным именем домена или как массив имён доменов.

dbplus_ropen

(только 4.1.0 - 4.2.1)

dbplus_ropen - открывает локально реляционный файл.

Описание

resource dbplus_ropen (string name)

dbplus_ropen() открывает реляционный файл file локально для быстрого доступа без перегрузки линий связи клиент/сервер. Доступ read-only, и только dbplus_current() и dbplus_next() могут применяться к возвращаемой связи/relation.

dbplus_rquery

(только 4.1.0 - 4.2.1)

dbplus_rquery - выполняет локальный (необработанный) AQL-запрос.

Описание

int dbplus_rquery (string query, string dbpath)

dbplus_rquery() выполняет локальный (необработанный) AQL-запрос с использованием интерпретатора AQL, встроенного в клиентскую библиотеку db++. dbplus_rquery() работает быстрее, чем dbplus_aql(), но при этом работает только с локальными данными.

dbplus_rrename

(только 4.1.0 - 4.2.1)

dbplus_rrename - переименовывает relation/связь.

Описание

int dbplus_rrename (resource relation, string name)

dbplus_rrename() изменяет имя связи relation на name.

dbplus_rsecindex

(только 4.1.0 - 4.2.1)

dbplus_rsecindex - создаёт новый вторичный/secondary индекс для связи/relation.

Описание

resource dbplus_rsecindex (resource relation, mixed domlist, int type)

dbplus_rsecindex() создаёт новый вторичный индекс для relation, состоящий из доменов, специфицированных списком domlist, имеющим тип type.

domlist может быть передан как единая строка имени домена или как массив имён доменов.

dbplus_runlink

(только 4.1.0 - 4.2.1)

dbplus_runlink - удаляет relation из файловой системы.

Описание

int dbplus_runlink (resource relation)

dbplus_unlink() закрывает и удаляет relation.

dbplus_rzap

(только 4.1.0 - 4.2.1)

dbplus_rzap - удаляет все пары/tuples из связи/relation.

Описание

int dbplus_rzap (resource relation)

dbplus_rzap() удаляет все пары из relation.

dbplus_savepos

(только 4.1.0 - 4.2.1)

dbplus_savepos - ???

Описание

int dbplus_savepos (resource relation)

Ещё не реализована.

dbplus_setindex

(только 4.1.0 - 4.2.1)

dbplus_setindex - ???

Описание

int dbplus_setindex (resource relation, string idx_name)

Ещё не реализована.

dbplus_setindexbynumber

(только 4.1.0 - 4.2.1)

dbplus_setindexbynumber - ???

Описание

int dbplus_setindexbynumber (resource relation, int idx_number)

Ещё не реализована.

dbplus_sql

(только 4.1.0 - 4.2.1)

dbplus_sql - выполняет SQL-запрос.

Описание

resource dbplus_sql (string query, string server, string dbpath)

Реализации ещё нет.

dbplus_tcl

(только 4.1.0 - 4.2.1)

dbplus_tcl - выполняет TCL-код на сервере.

Описание

int dbplus_tcl (int sid, string script)

Сервер db++ подготавливает интерпретатор TCL для каждого клиентского соединения. Этот интерпретатор даёт серверу возможность выполнять код TCL, предоставляемый клиентом, как особую хранимую процедуру, чтобы повысить производительность операций с БД путём исключения трансфера данных client/server и переключений контекста.

Для работы функции dbplus_tcl() необходимо передавать id клиентского соединения коду скрипта TCL script. dbplus_resolve() предоставляет этот connection id. Эта функция возвращает то, что возвращает TCL-код, или сообщение об ошибке TCL, если TCL-код терпит неудачу.

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

dbplus_tremove

(только 4.1.0 - 4.2.1)

dbplus_tremove - удаляет пару/tuple и возвращает новую текущую tuple.

Описание

int dbplus_tremove (resource relation, array tuple [, array current])

dbplus_tremove() удаляет tuple из relation, если она полностью совпадает с tuple в этой relation. current, если задан, содержит данные о новой текущей tuple после вызова dbplus_tremove().

dbplus_undo

(только 4.1.0 - 4.2.1)

dbplus_undo - ???

Описание

int dbplus_undo (resource relation)

Реализации ещё нет.

dbplus_undoprepare

(только 4.1.0 - 4.2.1)

dbplus_undoprepare - ???

Описание

int dbplus_undoprepare (resource relation)

Реализации ещё нет.

dbplus_unlockrel

(только 4.1.0 - 4.2.1)

dbplus_unlockrel - освобождает блокировку связи/relation.

Описание

int dbplus_unlockrel (resource relation)

dbplus_unlockrel() освобождает блокировку, полученную ранее функцией dbplus_lockrel().

dbplus_unselect

(только 4.1.0 - 4.2.1)

dbplus_unselect - удаляет ограничение со связи/relation.

Описание

int dbplus_unselect (resource relation)

Вызов dbplus_unselect() удаляет ограничение/constraint, ранее установленное функцией dbplus_find() для relation.

dbplus_update

(только 4.1.0 - 4.2.1)

dbplus_update - обновляет специфицированную tuple в relation.

Описание

int dbplus_update (resource relation, array old, array new)

dbplus_update() замещает tuple, заданную параметром old, данными из new, если (и только если) old полностью совпадает с tuple в relation.

dbplus_xlockrel

(только 4.1.0 - 4.2.1)

dbplus_xlockrel - запрашивает исключительную блокировку связи/relation.

Описание

int dbplus_xlockrel (resource relation)

dbplus_xlockrel() запрашивает эксклюзивную блокировку для relation, предотвращающую даже чтение другими клиентами.

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

dbplus_xunlockrel

(только 4.1.0 - 4.2.1)

dbplus_xunlockrel - освобождает исключительную блокировку связи/relation.

Описание

int dbplus_xunlockrel (resource relation)

dbplus_xunlockrel() освобождает исключительную блокировку связи relation, полученную ранее функцией dbplus_xlockrel().

dbx_close

(PHP 4 >= 4.0.6)

dbx_close - закрывает открытое соединение/базу данных.

Описание

bool dbx_close (object link_identifier)

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

dbx_compare

(PHP 4 >= 4.1.0)

dbx_compare - сравнивает два ряда для целей сортировки.

Описание

int dbx_compare (array row_a, array row_b, string column_key [, int flags])

dbx_compare() возвращает 0, если row_a[$column_key] равно row_b[$column_key], и 1 или -1, если первое больше или меньше сторого, соответственно, или наоборот, если flag установлен на DBX_CMP_DESC.
dbx_compare() это вспомогательная функция в дополнение к dbx_sort(), облегчающая создание и использование этой специальной функции сортировки.

Параметр flags может быть установлен для специфицирования направления сравнения:

DBX_CMP_ASC - в порядке возрастания

DBX_CMP_DESC - в порядке убывания

и предпочтительный тип сравнения:

DBX_CMP_NATIVE - нет конвертации типов

DBX_CMP_TEXT - сравнивать как строки

DBX_CMP_NUMBER - сравнивать численно

Одно из направлений и одна из констант типа могут комбинироваться битовой операцией OR (|). Значение по умолчанию параметра flags такое: DBX_CMP_ASC | DBX_CMP_NATIVE.

dbx_connect

(PHP 4 >= 4.0.6)

dbx_connect - открывает соединение/базу данных.

Описание

object dbx_connect (mixed module, string host, string database, string username, string password [, int persistent])

dbx_connect() возвращает объект при успехе, FALSE при ошибке. Если соединение установлено, но БД не может быть выбрана, соединение закрывается и возвращается FALSE. Параметр persistent может быть установлен для DBX_PERSISTENT, и в этом случае создаётся постоянное/persistent соединение.

Параметр module может быть строкой или константой, хотя вторая предпочтительней. Возможные значения даны ниже, но помните, что они работают только в том случае, если модуль реально загружен.

DBX_MYSQL или "mysql"

DBX_ODBC или "odbc"

DBX_PGSQL или "pgsql"

DBX_MSSQL или "mssql"

DBX_FBSQL или "fbsql" (начиная с PHP 4.1.0)

DBX_SYBASECT или "sybase_ct" (начиная с PHP 4.2.0)

Параметры host, database, username и password ожидаются, но не всегда используются, так как это зависит от функций соединения для абстрактного модуля.

Возвращаемый object имеет три свойства:

database

Это имя выбранной в данный момент БД.

handle

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

dbx_error

(PHP 4 >= 4.0.6)

dbx_error - выводит сообщение об ошибке последнего вызова функции в модуле (не просто в соединении).

Описание

string dbx_error (object link_identifier)

dbx_error() возвращает строку с сообщением об ошибке от последнего вызова функции абстрактного модуля (например, mysql-модуля). Если есть несколько соединений с одним и тем же модулем, выдаётся просто последняя ошибка. Если имеются соединения в различных модулях, возвращается самая последняя ошибка для модуля, специфицированного параметром link_identifier.

Пример 1. dbx_error()

<?php
$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password")
or die ("Could not connect");
$result = dbx_query($link, "select id from non_existing_table");
if ( $result == 0 ) {
echo dbx_error ($link);
}
dbx_close ($link);
?>

Примечание: всегда просматривайте также соответствующую документацию модуля.

Сообщение об ошибке для Microsoft SQL Server является результатом работы функции mssql_get_last_message().

dbx_query

(PHP 4 >= 4.0.6)

dbx_query - посылает запрос и получает все результаты (если имеются).

Описание

object dbx_query (object link_identifier, string sql_statement [, long flags])

dbx_query() возвращает объект или 1 при успехе и 0 при неудаче. Результирующий объект возвращается только в том случае, если запрос, заданный в sql_statement, производит результирующий набор.

Пример 1. Как обрабатывать результирующее значение

dbx_sort

(PHP 4 >= 4.0.6)

dbx_sort - сортирует результат dbx_query с помощью специальной функции сортировки.

Описание

bool dbx_sort (object result, string user_compare_function)

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

Примечание: лучше всегда использовать SQL-оператор ORDER BY вместо dbx_sort(), если это возможно.

dcgettext

(PHP 3>= 3.0.7, PHP 4)

dcgettext - переопределяет домен для отдельного lookup/просмотра.

Описание

string dcgettext (string domain, string message, int category)

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

dcngettext

(PHP 4 >= 4.2.0)

dcngettext - множественная версия dcgettext.

Описание

string dcngettext (string domain, string msgid1, string msgid2, int n, int category)

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

debugger_off

(PHP 3)

debugger_off - отключает внутренний отладчик PHP.

Описание

int debugger_off (void)

Отключает внутренний отладчик PHP. Отладчик всё еще находится в стадии разработки.

debugger_on

(PHP 3)

debugger_on - включает внутренний отладчик PHP.

Описание

int debugger_on (string address)

Включает внутренний отладчик PHP, соединяя его с address. Отладчик всё ещё находится в стадии разработки.

decbin

(PHP 3, PHP 4)

decbin - десятеричное в двоичное.

Описание

string decbin (int number)

Возвращает строку - двоичное представление данного аргумента number. Наибольшее возможное число для конвертации, 4294967295 в 10-ричном выражении, результирует в строку из 32 единиц.

См. также bindec(). dechex

decoct

(PHP 3, PHP 4)

decoct - 10-ричное в 8-ричное.

Описание

string decoct (int number)

Возвращает строку - 8-ричное представление данного аргумента number. Наибольшее 10-ричное число, которое может быть конвертировано, это 2147483647, дающее "17777777777".

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

define

(PHP 3, PHP 4)

define - определяет именованную константу.

Описание

bool define (string name, mixed value [, bool case_insensitive])

Определяет именованную константу. См. также раздел о константах.

Имя константы задаётся параметром name; значение - параметром value.

Имеет также необязательный третий параметр case_insensitive. Если задано значение TRUE, константа будет определена с учётом регистра. По умолчанию - с учётом регистра; т.е. CONSTANT и Constant это разные значения.

define_syslog_variables

(PHP 3, PHP 4 )

define_syslog_variables - инициализирует все константы, относящиеся к syslog.

Описание

void define_syslog_variables ( void)

Инициализирует все константы, используемые в syslog-функциях.

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

defined

(PHP 3, PHP 4)

defined - проверяет, существует ли данная именованная константа.

Описание

bool defined (string name)

Возвращает TRUE, если именованная константа name определена, FALSE в ином случае.

Пример 1. Проверка констант

<?php
if (defined("CONSTANT")){ // Обратите внимание на наличие кавычек
echo CONSTANT; //
}
?>

См. также define(), constant(), get_defined_constants() и раздел Константы.

deg2rad

(PHP 3>= 3.0.4, PHP 4)

deg2rad - конвертирует градусы в радианы.

Описание

float deg2rad (float number)

Эта функция конвертирует number из градусов в радианы.

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

delete

(unknown)

delete - болванка вхождения учебника.

Описание

void delete (string file)

Эта статья - болванка вхождения учебника для успокоения тех, кто ищет unlink() или unset() в неправильном месте.

См. также unlink() для удаления файлов, unset() - для удаления переменных.

dgettext

(PHP 3>= 3.0.7, PHP 4)

dgettext - переопределяет текущий домен.

Описание

string dgettext (string domain, string message)

Функция dgettext() позволяет переопределять текущий домен просмотра отдельного сообщения.

die

(unknown)

die - псевдоним exit().

Описание

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

dio_close

(PHP 4 >= 4.2.0)

dio_close - закрывает дескриптор файла, заданный параметром fd.

Описание

void dio_close (resource fd)

Функция dio_close() закрывает дескриптор resource.

dio_fcntl

(PHP 4 >= 4.2.0)

dio_fcntl - выполняет функцию fcntl c-библиотеки на дескрипторе fd.

Описание

mixed dio_fcntl (resource fd, int cmd [, mixed arg])

Функция dio_fcntl() выполняет операции, специфицированные параметром cmd, с дескриптором файла fd. Некоторые команды требуют предоставления дополнительных аргументов args.

arg это ассоциативный массив, когда cmd имеет значение F_SETLK или F_SETLLW, со следующими ключами: "start" - смешение, где начинается блокировка. "length" - размер блокированной области. zero означает конец файла. "wenth" - где относится к l_start: может быть SEEK_SET, SEEK_END и SEEK_CUR. "type" - тип блокировки: может быть F_RDLCK (read lock), F_WRLCK (write lock) или F_UNLCK (unlock).

cmd может быть одной из следующих операций: F_SETLK - блокировка установлена или очищена. Если блокировка удерживается кем-либо ещё, dio_fcntl() возвращает -1. F_SETLKW - похожа на F_SETLK, но в случае, когда блокировка удерживается кем-либо ещё, dio_fcntl() ожидает, пока блокировка не будет освобождена. F_GETLK - dio_fcntl() возвращает ассоциативный массив (как описано выше), если кто-нибудь ещё предотвращает блокировку. Если препятствий нет, ключ "type" будет установлен F_UNLCK. F_DUPFD - находит наименьший нумерованный дескриптор файла, больше или равный arg, и возвращает его.

dio_open

(PHP 4 >= 4.2.0)

dio_open - открывает новый файл filename со специфицированным допуском flags и допуском на создание mode.

Описание

resource dio_open (string filename, int flags [, int mode])

dio_open() открывает файл и возвращает для него новый дескриптор файла, или -1, если возникнет ошибка. Если flags это O_CREAT, необязательный третий параметр mode устанавливает режим файла (разрешение на создание). Параметр flags может быть одним из: O_RDONLY - открывает файл для чтенияO_WRONLY - открывает файл для записи O_RDWR - открывает файл для чтения и записиПараметр flags может также содержать комбинации следующих флагов: O_CREAT - создаёт файл, если он не существуетO_EXCL - когда и O_CREAT, и O_EXCL установлены, dio_open() терпит неудачу, если файл уже существуетO_TRUNC - если файл существует и открыт для записи, он усекается до нулевого размераO_APPEND - операции записи записывают данные в конец файла O_NONBLOCK - устанавливает неблокирующий режим

dio_read

(PHP 4 >= 4.2.0)

dio_read - читает n байтов из fd и возвращает их; если n не специфицирован, читает 1k блок.

Описание

string dio_read (resource fd [, int n])

Функция dio_read() читает и возвращает n байт из файла с дескриптором resource. Если n не специфицировано, dio_read() читает блок размером 1K и возвращает его.

dio_seek

(PHP 4 >= 4.2.0)

dio_seek - ищет pos в fd из whence.

Описание

int dio_seek (resource fd, int pos, int whence)

Функция dio_seek() используется для изменения позиции в файле с дескриптором resource. Параметр whence специфицирует, как должна интерпретироваться позиция pos:

SEEK_SET - pos специфицируется от начала файла.

SEEK_CUR - специфицирует, что pos это количество символов от текущей позиции в файле. Это количество может быть положительным или отрицательным.

SEEK_END - специфицирует, что pos это количество символов от конца файла. Отрицательное значение специфицирует позицию в пределах текущего размера файла; положительное значение специфицирует позицию после конца файла. Если вы установите позицию после текущего конца файла и запишете данные, вы расширите файл нулями до этой позиции.

dio_stat

(PHP 4 >= 4.2.0)

dio_stat - возвращает статистику о дескрипторе файла fd.

Описание

array dio_stat (resource fd)

Функция dio_stat() возвращает информацию о файле с дескриптором fd. dio_stat() возвращает ассоциативный массив со следующими ключами:

"device" - устройство

"inode" - inode

"mode" - режим

"nlink" - количество жёстких ссылок

"uid" - id пользователя

"gid" - id группы

"device_type" - тип устройства (если это inode-устройство)

"size" - общий размер в байтах

"blocksize" - размер блока

"blocks" - количество занятых блоков

"atime" - время последнего доступа к

"mtime" - время последней модификации

"ctime" - время последнего изменения

При ошибке dio_stat() возвращает NULL.

dio_truncate

(PHP 4 >= 4.2.0)

dio_truncate - усекает файл с дескриптором fd на offset байтов.

Описание

bool dio_truncate (resource fd, int offset)

Функция dio_truncate() вызывает усечение файла, на который ссылается fd, на offset байтов. Если первоначальный файл был больше заданного размера, лишние данные теряются. Если первоначальный файл был меньше заданного размера, то не определено, остаётся файл тех же размеров или увеличивается. В последнем случае расширенная часть читается как нулевые байты. Возвращает 0 при успешном выполнении, иначе -1.

dio_write

(PHP 4 >= 4.2.0)

dio_write - записывает данные в fd с необязательным усечением длины.

Описание

int dio_write (resource fd, string data [, int len])

Функция dio_write() записывает до len байтов из data в файл fd. Если len не специфицирован, dio_write() записывает все data в специфицированный файл. dio_write() возвращает количесвто байтов, записанных в fd.

dirname

(PHP 3, PHP 4)

dirname - возвращает компонент пути - имя директории.

Описание

string dirname (string path)

Имея заданный путь к файлу, эта функция возвращает имя директории.

В Windows слэш (/) и обратный слэш (\) используются как символы-разделители. В других системах это слэш (/).

disk_free_space

(PHP 4 >= 4.1.0)

disk_free_space - возвращает свободное пространство в данной директории.

Описание

float disk_free_space (string directory)

Имея строку с directory, эта функция возвратит количество байтов, доступных в соответствующей файловой системе или разделе диска.

disk_total_space

(PHP 4 >= 4.1.0)

disk_total_space - возвращает общий размер диска.

Описание

float disk_total_space (string directory)

Имея строку с directory, эта функция возвращает общее количество байтов соответствующей файловой системы или раздела диска.

diskfreespace

(PHP 3>= 3.0.7, PHP 4)

diskfreespace - псевдоним disk_free_space().

Описание

float diskfreespace (string directory)

Это не рекомендуемый к использованию псевдоним функции disk_free_space(). Используйте лучше саму функцию.

dl

(PHP 3, PHP 4)

dl - загружает РНР-расширение на этапе прогона.

Описание

bool dl (string library)

Загружает расширение PHP, заданное параметром library. Параметр library это только имя загружаемого файла расширения, которое также зависит от используемой платформы. Например, расширение sockets (если скомпилировано как shared-модуль, не по умолчанию!) может называться sockets.so на unix-платформах и php_sockets.dll - на платформах windows.

Возвращает TRUE при успехе, FALSE при неудаче . Если функциональность загружаемых модулей недоступна (см. Примечания) или отключена (через отключение enable_dl или включением safe_mode в php.ini), возникает E_ERROR, и выполнение останавливается. Если dl() терпит неудачу из-за того, что специфицированная библиотека не может быть загружена, в дополнение к FALSE выдаётся сообщение E_WARNING.

Используйте extension_loaded() для проверки доступности расширения. Это работает и с встроенными, и с динамическими расширениями (через php.ini или dl()).

Пример:

dngettext

(PHP 4 >= 4.2.0)

dngettext - множественная версия dgettext.

Описание

string dngettext (string domain, string msgid1, string msgid2, int n)

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

DomAttribute->name

(unknown)

DomAttribute->name - возвращает имя атрибута.

Описание

bool DomAttribute->name (void)

Эта функция возвращает имя атрибута.

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

DomAttribute->specified

(unknown)

DomAttribute->specified - проверяет, специфицирован ли атрибут.

Описание

bool DomAttribute->specified (void)

Просмотрите стандарт DOM для получения детального разъяснения.

DomAttribute->value

(unknown)

DomAttribute->value - возвращает значение атрибута.

Описание

bool DomAttribute->value (void)

Эта функция возвращает значение атрибута.

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

DomDocument->add_root [не рекомендуется применять]

(unknown)

DomDocument->add_root [не рекомендуется применять] - добавляет root-узел.

Описание

resource DomDocument->add_root (string name)

Добавляет узел корневого элемента в dom-документ и возвращает этот новый узел. Имя элемента задаётся в передаваемом параметре.

DomDocument->create_attribute

(unknown)

DomDocument->create_attribute - создаёт новый атрибут.

Описание

object DomDocument->create_attribute (string name, string value)

Эта функция возвращает новый экземпляр класса DomAttribute. Имя атрибута является значением первого параметра. Значением атрибута является значение второго параметра. Этот узел не будет показан в документе, если он не вставлен с помощью, например, DomNode_append_child().

return-значение будет false, если возникла ошибка.

См. также DomNode_append_child(), DomDocument_create_element(), DomDocument_create_text(), DomDocument_create_cdata_section(), DomDocument_create_processing_instruction(), DomDocument_create_entity_reference(), DomNode_insert_before().

DomDocument->create_cdata_section

(unknown)

DomDocument->create_cdata_section - создаёт новый узел cdata.

Описание

string DomDocument->create_cdata_section (string content)

Эта функция возвращает новый экземпляр класса DomCData. Содержимым cdata является значение переданного параметра. Этот узел не будет показан в документе, если только он не вставлен с помощью, например, DomNode_append_child().

return-значением будет false, если возникает ошибка.

См. также DomNode_append_child(), DomDocument_create_element(), DomDocument_create_text(), DomDocument_create_attribute(), DomDocument_create_processing_instruction(), DomDocument_create_entity_reference(), DomNode_insert_before().

DomDocument->create_comment

(unknown)

DomDocument->create_comment - создаёт новый узел комментария.

Описание

object DomDocument->create_comment (string content)

Эта функция возвращает новый экземпляр класса DomComment. Содержимым комментария является значение переданного параметра. Этот узел не будет виден в документе, если только он не вставлен с помощью, например, DomNode_append_child().

return-значением будет false, если возникает ошибка.

DomDocument->create_element

(unknown)

DomDocument->create_element - создаёт новый узел элемента.

Описание

object DomDocument->create_element (string name)

Эта функция возвращает новый экземпляр класса DomElement. Имя тэга элемента является значением переданного параметра. Этот узел не будет виден в документе, если он не вставлен с помощью, например, DomNode_append_child().

return-значением будет false, если возникает ошибка.

См. также DomNode_append_child(), DomDocument_create_text(), DomDocument_create_comment(), DomDocument_create_attribute(), DomDocument_create_processing_instruction(), DomDocument_create_entity_reference(), DomNode_insert_before().

DomDocument->create_entity_reference

(unknown)

DomDocument->create_entity_reference.

Описание

object DomDocument->create_entity_reference (string content)

Эта функция возвращает новый экземпляр класса DomEntityReference. Значением ссылки на мнемонику/entity является значение переданного параметра. Этот узел не будет виден в документе, если он не вставлен с помощью, например, DomNode_append_child().

return-значением будет false, если возникает ошибка.

DomDocument->create_processing_instruction

(unknown)

DomDocument->create_processing_instruction - создаёт новый узел PI.

Описание

string DomDocument->create_processing_instruction (string content)

Эта функция возвращает новый экземпляр класса DomCData. Содержимым pi является значение, переданное в качестве параметра. Этот узел не будет виден в документе, если он не вставлен с помощью, например, DomNode_append_child().

return-значением будет false, если возникает ошибка.

См. также DomNode_append_child(), DomDocument_create_element(), DomDocument_create_text(), DomDocument_create_cdata_section(), DomDocument_create_attribute(), DomDocument_create_entity_reference(), DomNode_insert_before().

DomDocument->create_text_node

(unknown)

DomDocument->create_text_node - создаёт новый текстовый узел.

Описание

object DomDocument->create_text_node (string content)

Эта функция возвращает новый экземпляр класса DomText. Контекстом текста является значение, переданного параметра. Этот узел не будет виден в документе, если он не вставлен с помощью, например, DomNode_append_child().

return-значением будет false, если возникает ошибка.

См. также DomNode_append_child(), DomDocument_create_element(), DomDocument_create_comment(), DomDocument_create_text(), DomDocument_create_attribute(), DomDocument_create_processing_instruction(), DomDocument_create_entity_reference(), DomNode_insert_before().

DomDocument->doctype

(unknown)

DomDocument->doctype - возвращает тип документа.

Описание

object DomDocument->doctype (void)

Эта функция возвращает объект класса DomDocumentType. В версиях до PHP 4.3 это был класс Dtd, но DOM Standard не знает о таком классе.

См. также методы класса DomDocumentType.

DomDocument->document_element

(unknown)

DomDocument->document_element - возвращает узел корневого элемента.

Описание

object DomDocument->document_element (void)

Эта функция возвращает узел корневого элемента документа.

Следующий пример возвращает просто элемент CHAPTER и печатает его. Другой узел - комментарий/comment - не возвращается.

DomDocument->dump_file

(unknown)

DomDocument->dump_file - выполняет дамп внутреннего дерева XML обратно в файл.

Описание

string DomDocument->dump_file (string filename [, bool compressionmode [, bool format]])

Создаёт XML-документ из dom-представления. Эта функция обычно вызывается после построения нового dom-документа с нуля, как далее в примере. Параметр format специфицирует, должен ли вывод форматироваться точно, или нет. Первый параметр специфицирует имя файла filename, а второй параметр - должен ли файл сжиматься.

DomDocument->dump_mem

(unknown)

DomDocument->dump_mem - выполняет дамп внутреннего XML-дерева обратно в строку.

Описание

string DomDocument->dump_mem ([bool format])

Создаёт XML-документ из dom-представления. Эта функция обычно вызывается после построения нового dom-документа с нуля, как далее в примере. format специфицирует, должен ли вывод точно форматироваться.

Пример 1. Создание шапки/header простого HTML-документа

DomDocument->get_element_by_id

(unknown)

DomDocument->get_element_by_id - ищет элемент с определённым id.

Описание

object DomDocument->get_element_by_id (string id)

Эта функция аналогична DomDocument_get_elements_by_tagname(), но ищет элемент по заданному id. В соответствии со стандартом DOM необходимо DTD, которое определяет атрибут ID как имеющий тип ID, хотя текущая реализация просто выполняет xpath-поиск "//*[@ID = '%s']". Это не соответствует DOM-стандарту, который требует возвращать null, если не известно, какой атрибут имеет тип id. Вероятно это поведение будет зафиксировано, поэтому не полагайтесь на текущее поведение.

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

DomDocument->get_elements_by_tagname

(unknown)

DomDocument->get_elements_by_tagname.

Описание

array DomDocument->get_elements_by_tagname (string name)

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

DomDocument->html_dump_mem

(unknown)

DomDocument->html_dump_mem - выполняет дамп внутреннего дерева XML обратно в строку как HTML.

Описание

string DomDocument->html_dump_mem (void)

Создаёт HTML-документ из dom-представления. Эта функция обычно вызывается после построения нового dom-документа с нуля, как в следующем примере.

DomDocumentType->entities

(unknown)

DomDocumentType->entities - возвращает список вхождений.

Описание

array DomDocumentType->entities (void)

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

DomDocumentType->internal_subset

(unknown)

DomDocumentType->internal_subset - возвращает внутренний поднабор.

Описание

bool DomDocumentType->internal_subset (void)

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

DomDocumentType->name

(unknown)

DomDocumentType->name - возвращает имя типа документа.

Описание

string DomDocumentType->name (void)

Эта функция возвращает имя типа документа.

DomDocumentType->notations

(unknown)

DomDocumentType->notations - возвращает список нотаций.

Описание

array DomDocumentType->notations (void)

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

DomDocumentType->public_id

(unknown)

DomDocumentType->public_id - возвращает public id типа документа.

Описание

string DomDocumentType->public_id (void)

Эта функция возвращает public id типа документа.

Следующий пример не выводит/echo ничего.

DomDocumentType->system_id

(unknown)

DomDocumentType->system_id - возвращает системный id типа документа.

Описание

string DomDocumentType->system_id (void)

Возвращает системный id типа документа.

Следующий пример выводит '/share/sgml/Norman_Walsh/db3xml10/db3xml10.dtd'.

DomElement->get_attribute

(unknown)

DomElement->get_attribute - возвращает значение атрибута.

Описание

object DomElement->get_attribute (string name)

Возвращает атрибут с именем name текущего узла.

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

DomElement->get_attribute_node

(unknown)

DomElement->get_attribute_node - возвращает значение атрибута.

Описание

object DomElement->get_attribute_node (object attr)

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

DomElement->get_elements_by_tagname

(unknown)

DomElement->get_elements_by_tagname - добавляет новый атрибут.

Описание

bool DomElement->get_elements_by_tagname (string name)

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

DomElement->has_attribute

(unknown)

DomElement->has_attribute - добавляет новый атрибут.

Описание

bool DomElement->has_attribute (string name)

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

DomElement->remove_attribute

(unknown)

DomElement->remove_attribute - добавляет новый атрибут.

Описание

bool DomElement->remove_attribute (string name)

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

DomElement->set_attribute

(unknown)

DomElement->set_attribute - добавляет новый атрибут.

Описание

bool DomElement->set_attribute (string name, string value)

Устанавливает в атрибут с данным именем name данное значение/value. Если атрибут не существует, он будет создан.

DomElement->set_attribute_node

(unknown)

DomElement->set_attribute_node - добавляет новый атрибут.

Описание

bool DomElement->set_attribute_node (object attr)

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

DomElement->tagname

(unknown)

DomElement->tagname - возвращает имя элемента.

Описание

string DomElement->tagname (void)

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