DomNode->append_child

(unknown)

DomNode->append_child - добавляет нового потомка/child в конец списка потомков.

Описание

object DomNode->append_child (object newnode)

Эта функция присоединяет потомка к списку потомков или создаёт новый список. Потомок может  быть создан, например, функцией DomDocument_create_element(), DomDocument_create_text() etc. или просто путём использования другого узла.

Перед присоединением потомок сначала дублируется. Следовательно, новый потомок является совершенно новой копией, которая может изменяться без влияния на узел, который был передан этой функции. Если передаваемый узел сам имеет потомков, они также продублируются, что позволяет довольно легко дублировать большие части xml-документа.
return-значение это присоединённый потомок. Если вы планируете в дальнейшем модифицировать присоединённый потомок, вы обязаны использовать возвращаемый узел.

В следующем примере узел нового элемента добавляется в документ, и  атрибут "align" получает значение "left".

DomNode->append_sibling

(unknown)

DomNode->append_sibling - добавляет к узлу нового родственника/sibling.

Описание

object DomNode->append_sibling (object newnode)

Эта функция присоединяет родственника к существующему узлу. Потомок может быть создан с помощью, например, DomDocument_create_element(), DomDocument_create_text() etc. или просто путём использования другого узла.

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

потомков, они также продублируются, что позволяет довольно легко дублировать большие части xml-документа.
return-значение это присоединённый потомок. Если вы планируете в дальнейшем модифицировать присоединённый потомок, вы обязаны использовать возвращаемый узел.

Эта функция была добавлена с целью предоставить поведение DomNode_append_child(), как она работает в версиях до PHP 4.2.

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

DomNode->attributes

(unknown)

DomNode->attributes - возвращает список атрибутов.

Описание

array DomNode->attributes (void)

Эта функция возвращает массив атрибутов только в том случае, если узел имеет тип XML_ELEMENT_NODE.

DomNode->child_nodes

(unknown)

DomNode->child_nodes - возвращает потомков узла.

Описание

array DomNode->child_nodes (void)

Возвращает всех потомков данного узла.

См. также DomNode_next_sibling(), DomNode_previous_sibling().

DomNode->clone_node

(unknown)

DomNode->clone_node - клонирует узел.

Описание

object DomNode->clone_node (void)

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

DomNode->dump_node

(unknown)

DomNode->dump_node - дампирует отдельный узел.

Описание

string DomNode->dump_node (void)

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

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

DomNode->first_child

(unknown)

DomNode->first_child - возвращает первого потомка узла.

Описание

bool DomNode->first_child (void)

Возвращает первого потомка данного узла.

См. также DomNode_last_child(), DomNode_next_sibling(), DomNode_previous_sibling().

DomNode->get_content

(unknown)

DomNode->get_content - получает содержимое узла.

Описание

string DomNode->get_content (void)

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

DomNode->has_attributess

(unknown)

DomNode->has_attributess - проверяет, имеет ли узел атрибуты.

Описание

bool DomNode->has_attributes (void)

Эта функция проверяет, имеет ли данный узел атрибуты.

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

DomNode->has_child_nodes

(unknown)

DomNode->has_child_nodes - проверяет, имеет ли узел потомков.

Описание

bool DomNode->has_child_nodes (void)

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

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

DomNode->insert_before

(unknown)

DomNode->insert_before - вставляет новый узел как потомок.

Описание

object DomNode->insert_before (object newnode, object refnode)

Эта функция вставляет новый узел newnode непосредственно перед узлом refnode. Возвращаемое значение это вставленный узел. Если вы планируете модифицировать присоединённого потомка, вы обязаны использовать возвращённый узел.

DomNode_insert_before() очень напоминает DomNode_append_child(), как видно из следующего примера, где делается то же самое, что и в примере для DomNode_append_child().

Пример 1. Добавление потомка

include("example.inc");
if(!$dom = domxml_open_mem($xmlstr)) {
echo "Error while parsing the document\n";
exit;
}
$elements = $dom->get_elements_by_tagname("informaltable");
print_r($elements);
$element = $elements[0];
$newnode = $element->insert_before($element, $element);
$children = $newnode->children();
$attr = $children[1]->set_attribute("align", "left");
echo "<PRE>";
$xmlfile = $dom->dump_mem();
echo htmlentities($xmlfile);
echo "</PRE>";

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

DomNode->is_blank_node

(unknown)

DomNode->is_blank_node - проверяет, чистый ли узел.

Описание

bool DomNode->is_blank_node (void)

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

DomNode->last_child

(unknown)

DomNode->last_child - возвращает последнего потомка узла.

Описание

object DomNode->last_child (void)

Возвращает последнего потомка данного узла.

См. также DomNode_first_child(), DomNode_next_sibling(), DomNode_previous_sibling().

DomNode->next_sibling

(unknown)

DomNode->next_sibling - возвращает следующего родственника узла.

Описание

object DomNode->next_sibling (void)

Эта функция возвращает следующего родственника текущего узла. Если следующего родственника нет, возвращает false. Вы можете использовать эту функцию для итерирования по всем потомкам узла, как показано в примере.

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

DomNode->node_name

(unknown)

DomNode->node_name - возвращает имя узла.

Описание

string DomNode->node_name (void)

Возвращает имя данного узла. Имя имеет различные значения для различных типов узлов, как показано в таблице.

Таблица 1. Смысл значений

DomNode->node_type

(unknown)

DomNode->node_type - возвращает тип узла.

Описание

int DomNode->node_type (void)

Возвращает тип данного узла. Все возможные типы перечислены в таблице во введении.

DomNode->node_value

(unknown)

DomNode->node_value - возвращает значение узла.

Описание

string DomNode->node_value (void)

Возвращает значение данного узла. Значение имеет разный смысл для разных типов узлов, как видно из таблицы.

Таблица 1. Смысл значений

DomNode->owner_document

(unknown)

DomNode->owner_document - возвращает документ, к которому принадлежит данный узел.

Описание

object DomNode->owner_document (void)

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

Следующие пример создаёт два идентичных списка потомков.

DomNode->parent_node

(unknown)

DomNode->parent_node - возвращает предка данного узла.

Описание

object DomNode->parent_node (void)

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

В следующем примере показаны два идентичных списка потомков.

DomNode->prefix

(unknown)

DomNode->prefix - возвращает префикс пространства имён узла.

Описание

string DomNode->prefix (void)

Возвращает префикс пространства имён данного узла.

DomNode->previous_sibling

(unknown)

DomNode->previous_sibling - возвращает предыдущего родственника/sibling узла.

Описание

object DomNode->previous_sibling (void)

Эта функция возвращает предыдущего родственника/sibling текущего узла.

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

DomNode->remove_child

(unknown)

DomNode->remove_child - удаляет потомка из списка потомков.

Описание

object DomNode->remove_child (object oldchild)

Эта функция удаляет потомка из списка потомков. Если потомок не может быть удалён или не является потомком, функция возвращает false. Если потомок может быть удалён, функция возвращает старого потомка.

DomNode->replace_child

(unknown)

DomNode->replace_child - замещает потомка.

Описание

object DomNode->replace_child (object oldnode, object newnode)

Эта функция замещает потомка oldnode переданным новым узлом. Если новый узел уже является потомком, он не будет добавляться вторично. Если старый узел не может быть найден, функция возвращает false. Если замещение удалось, возвращается старый узел.

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

DomNode->set_content

(unknown)

DomNode->set_content - устанавливает содержимое узла.

Описание

bool DomNode->set_content (void)

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

DomNode->set_name

(unknown)

DomNode->set_name - устанавливает имя узла.

Описание

bool DomNode->set_name (void)

Устанавливает имя узла.

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

DomNode->unlink_node

(unknown)

DomNode->unlink_node - удаляет узел.

Описание

object DomNode->unlink_node (void)

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

DomProcessingInstruction->data

(unknown)

DomProcessingInstruction->data - возвращает данные pi-узла.

Описание

string DomProcessingInstruction->data (void)

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

DomProcessingInstruction->target

(unknown)

DomProcessingInstruction->target - возвращает цель/target pi-узла.

Описание

string DomProcessingInstruction->target (void)

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

domxml_new_doc

(PHP 4 >= 4.2.1)

domxml_new_doc - создаёт новый пустой XML-документ.

Описание

object domxml_new_doc (string version)

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

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

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

domxml_open_file

(PHP 4 >= 4.2.1)

domxml_open_file - создаёт DOM-объект из XML-файла.

Описание

object domxml_open_file (string filename)

Функция разбирает документ XML в файле filename и возвращает объект класса "Dom document", имеющий свойства, перечисленные выше. Доступ к файлу - read-only.

Пример 1. Открытие xml-документа из файла

domxml_open_mem

(PHP 4 >= 4.2.1)

domxml_open_mem - создаёт DOM-объект XML-документа.

Описание

object domxml_open_mem (string str)

Функция разбирает XML-документ в str и возвращает объект класса "Dom document", имеющего указанные выше свойства. Эта функция, domxml_open_file() или domxml_new_doc(), обязана вызываться перед вызовом любых других функций.

domxml_version

(PHP 4 >= 4.1.0)

domxml_version - получает версию библиотеки XML.

Описание

string domxml_version (void)

Эта функция возвращает версию используемой в данный момент XML-библиотеки.

domxml_xmltree

(PHP 4 >= 4.2.1)

domxml_xmltree - создаёт дерево PHP-объектов их XML-документа.

Описание

object domxml_xmltree (string str)

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

Функция разбирает XML-документ в str и возвращает дерево PHP-объектов как разобранный документ. Эта функция изолирована от других функций, т.е. вы не можете получить доступ к этому дереву с помощью других функций. Модификация его, например, путём добавления узла, не имеет смысла, поскольку в настоящее время нет способа дампировать его как XML-файл. Однако эта функция может потребоваться при чтении файла и исследовании его содержимого.

dotnet_load

(unknown)

dotnet_load - загружает DOTNET-модуль.

Описание

int dotnet_load (string assembly_name [, string datatype_name [, int codepage]])

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

doubleval

(PHP 3, PHP 4 )

doubleval - псевдоним floatval().

Описание

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

Примечание: этот псевдоним - последствие переименования функций. В старых версиях PHP вам потребуется использовать это псевдоним функции floatval(), поскольку floatval() ещё отсутствовала в тех версиях.

each

(PHP 3, PHP 4)

each - возвращает текущую пару ключ/значение из массива и передвигает указатель массива.

Описание

array each (array array)

Возвращает текущую пару ключ/значение из массива array и продвигает указатель массива вперёд. Эта пара возвращается в виде массива из 4 элементов: ключей 0, 1, key и значения value. Элементы 0 и key содержат имя ключа элемента массива, а 1 и value содержат данные.

Если внутренний указатель массива указывает после конца содержимого массива, each() возвращает FALSE.

easter_date

(PHP 3>= 3.0.9, PHP 4)

easter_date - получает штамп времени UNIX для полночи Easter данного года.

Описание

int easter_date ([int year])

Возвращает штамп времени UNIX, соответствующий полночи Easter данного года.

Начиная с PHP 4.3.0, параметр year является необязательным, и по умолчанию используется текущий год в соответствии с локальным временем, если этот параметр опущен.

Предупреждение!: Эта функция сгенерирует предупреждение, если год находится вне диапазона штампов времени UNIX (т.е. до 1970 или после 2037).

easter_days

(PHP 3>= 3.0.9, PHP 4)

easter_days - получает дату - количество дней после 21 марта, на которую падает Easter в данном году.

Описание

int easter_days ([int year [, int method]])

Возвращает дату - количество дней после 21 марта, на которую падает Easter в данном году. Если год не специфицирован, по умолчанию используется текущий год.

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

Параметр method также был введён в PHP 4.3.0 и даёт возможность рассчитывать easter-даты на основе Григорианского календаря для лет 1582 - 1752, если имеет значение CAL_EASTER_ROMAN. См. календарные константы.

Эта функция может использоваться вместо easter_date() для расчёта Easter для тех лет, которые находятся вне диапазона штампов времени UNIX (до 1970 или после 2037).

ebcdic2ascii

(PHP 3>= 3.0.17)

ebcdic2ascii - транслирует строку из EBCDIC в ASCII.

Описание

int ebcdic2ascii (string ebcdic_str)

ebcdic2ascii() это функция, специфичная для Apache, которая доступна только в EBCDIC на основе ОС (OS/390, BS2000). Она транслирует EBCDIC-кодированную строку ebcdic_str в ASCII-эквивалент (binary safe/двоично безопасна) и возвращает результат.

См. также реверсную функцию ascii2ebcdic().

echo

(unknown)

echo - выводит одну или более строк.

Описание

echo (string arg1 [, string argn...])

Выводит все параметры.

echo() это в действительности не функция (это конструкция языка), так что вам не обязательно использовать здесь скобки. На практике, если вы хотите передать более одного параметра в echo, вы обязаны не заключать параметры в скобки. Нельзя использовать echo() в контексте функции переменной, вместо этого вы можете использовать print().

Пример 1. echo()

<?php
echo "Hello World";
echo "Этот текст занимает
несколько строчек. Символы новой строки
также выводятся.";
echo "Этот текст занимает\nнесколько строчек. Символы новой строки\nтакже выводятся.";
echo "Escap-ирование символов проведено \"Вроде этого\".";
//Вы можете использовать внутри операции echo переменные.
$foo = "foobar";
$bar = "barbaz";
echo "foo is $foo"; // foo это foobar
// При использовании одинарных кавычек будет печататься имя переменной, а не значение
echo 'foo is $foo'; // foo это $foo
// Если вы не используете никакие иные символы, вы можете просто echo переменные
echo $foo; // foobar
echo $foo,$bar; // foobarbarbaz
echo <<<END
Здесь использован синтаксис "here document" для вывода
нескольких строк с интерполяцией $variable. Заметьте, что
терминатор here document обязан появляться в строке
с символом "точка с запятой" без пробела!
END;
// Поскольку echo это не функция, следующий код - неправильный.
($some_var) ? echo('true'): echo('false');
// Однако следующий пример будет работать:
($some_var) ? print('true'): print('false'); // print это функция
echo $some_var ? 'true': 'false'; // изменение оператора
?>

echo() также имеет сокращённый синтаксис, где сразу после открывающего тэга идёт знак "равно".

I have <?=$foo?> foo.

Примечание: этот сокращённый синтаксис работает только при включённой установке конфигурации short_open_tag.

См. также print(), printf() и flush().

empty

(unknown)

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

Описание

boolean empty (mixed var)

Примечание: empty() это конструкция языка.

Это противоположно (boolean) var, за исключением того, что никакого предупреждения не генерируется, если переменная не установлена. См. конвертация в boolean.

end

(PHP 3, PHP 4)

end - устанавливает внутренний указатель массива на последний элемент.

Описание

mixed end (array array)

end() передвигает внутренний указатель массива array на последний элемент и возвращает этот элемент.

Пример 1. Простой пример end()

<?php
$fruits = array('apple','banana','cranberry');
print end($fruits); // cranberry
?>

См. также current(), each(), next() и reset().

ereg

(PHP 3, PHP 4)

ereg - совпадение с регулярным выражением.

Описание

int ereg (string pattern, string string [, array regs])

Примечание: preg_match(), которая использует Perl-совместимый синтаксис регулярного выражения, работает часто быстрее, чем ereg().

Ищет в строке string совпадения с регулярным выражением, данным в pattern.

Если совпадения найдены для подстроки в скобках из pattern и функция вызывается с третьим аргументом regs, совпадения будут сохранены в элементах массива regs.
$regs[1] содержит подстроку, которая начинается с первой левой скобки; $regs[2] содержит подстроку, которая начинается со второй, и так далее. $regs[0] содержит полную копию совпавшей строки.

Примечание: до (и включая) PHP 4.1.0 переменная $regs заполняется точно десятью элементами, хотя реально может совпасть больше или меньше 10 подстрок. Это не влияет на способность ereg() совпадать с б́ольшим количеством подстрок. Если совпадений нет, $regs не будет изменяться функцией ereg().

Поиск выполняется с учётом регистра символов/case sensitive.

Возвращает TRUE, если найдено совпадение для pattern в string, либо FALSE, если совпадений нет или возникла ошибка.

Следующий фрагмент кода (внимание, совки!!) принимает дату в формате ISO (YYYY-MM-DD) и печатает её в формате DD.MM.YYYY:

ereg_replace

(PHP 3, PHP 4)

ereg_replace - замещает регулярное выражение.

Описание

string ereg_replace (string pattern, string replacement, string string)

Примечание: preg_replace(), которая использует Perl-совместимый синтаксис регулярного выражения, часто работает быстрее, чем ereg_replace().

Эта функция сканирует string для поиска совпадений с pattern, затем заменяет совпавший текст строкой replacement.

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

Если pattern содержит подстроку в скобках, replacement может содержать подстроки вида \\digit, которые будут заменены текстом, совпавшим с digit'ной подстрокой в скобках; \\0 воспроизведёт всё содержимое строки. Может использоваться до 9 подстрок. Скобки могут вкладываться, и тогда они подсчитываются по открывающим скобкам.

Если совпадения в string не найдены, то string вернётся без изменений.

Например, следующий фрагмент кода печатает "This was a test" три раза:

Пример 1. ereg_replace()

eregi

(PHP 3, PHP 4)

eregi - совпадение с регулярным выражением без учёта регистра символов.

Описание

int eregi (string pattern, string string [, array regs])

Эта функция идентична ereg(), за исключением того, что она игнорирует различия в регистре символов алфавита.

eregi_replace

(PHP 3, PHP 4)

eregi_replace - замещает регулярное выражение, не учитывая регистр.

Описание

string eregi_replace (string pattern, string replacement, string string)

Эта функция идентична ereg_replace(), но игнорирует регистр алфавитных символов при поиске совпадений.

См. также ereg(), eregi() и ereg_replace().

error_log

(PHP 3, PHP 4)

error_log - высылает сообщение об ошибке.

Описание

int error_log (string message [, int message_type [, string destination [, string extra_headers]]])

Высылает сообщение об ошибке в error log web-сервера, TCP -порт или в файл. Первый параметр message это сообщение об ошибке, которое должно быть записано в лог-файл. Второй параметр, message_type, говорит, куда сообщение должно быть направлено:

Таблица 1. Типы error_log()

error_reporting

(PHP 3, PHP 4)

error_reporting - устанавливает, о каких ошибках PHP сообщается.

Описание

int error_reporting ([int level])

Устанавливает уровень сообщения об ошибках PHP и возвращает старый уровень. Уровень сообщения об ошибках это либо битовая маска, либо именованная константа. Использование именованной константы настоятельно рекомендуется для обеспечения совместимости с последующими версиями. После добавления уровней ошибок увеличивается диапазон целых чисел, так что старые уровни ошибок на базе целочисленных значений не всегда будут работать так, как задумано.

escapeshellarg

(PHP 4 >= 4.0.3)

escapeshellarg - escape-ирует (заменяет мнемониками) строку, используемую как аргумент оболочки.

Описание

string escapeshellarg (string arg)

escapeshellarg() добавляет одинарные кавычки вокруг строки и мнемонизирует любые имеющиеся одинарные кавычки, позволяя передавать строку непосредственно в функцию оболочки и рассматривать её как единый безопасный аргумент. Эта функция должна использоваться для escape-ирования отдельных аргументов shell-функций, приходящих от пользовательского ввода. shell-функции включают exec(), system() и операцию backtick. Стандартное использование таково:

system("ls ".escapeshellarg($dir));

См. также exec(), popen(), system() и операцию backtick.

escapeshellcmd

(PHP 3, PHP 4)

escapeshellcmd - escape-ирование метасимволов оболочки/shell.

Описание

string escapeshellcmd (string command)

escapeshellcmd() заменяет мнемониками любые символы в строке, что может использоваться для выполнения в оболочке произвольных команд. Эта функция должна использоваться для гарантирования того, что любые данные, приходящие от пользователя, escape-ируются, прежде чем передаются функциям exec() или system(), или операции backtick. Стандартное использование таково:

eval

(unknown)

eval - вычисляет строку как PHP-код.

Описание

mixed eval (string code_str)

eval() вычисляет строку, заданную в code_str, как код PHP. Помимо всего прочего, это может оказаться полезным для хранения кода в текстовом поле БД для последующего исполнения.

При использовании eval() необходимо помнить о нескольких вещах. Запомните, что передаваемая строка обязана быть правильным кодом PHP, включая окончание операторов точкой с запятой, чтобы разборщик не отвалил на строке после eval(), и правильное escap-ируйте в code_str.

Также помните, что значения, заданные переменным в eval(), останутся действовать затем и в основном скрипте.

Оператор return завершит вычисление строки немедленно. В PHP 4 eval() возвращает FALSE, если не вызвана return() в вычисляемом коде, и в этом случае возвращается значение, передаваемое в return(). В PHP 3 eval() не возвращает значения.

exec

(PHP 3, PHP 4)

exec - выполняет внешнюю программу.

Описание

string exec (string command [, array output [, int return_var]])

exec() выполняет данную команду command, но ничего не выводит. Она просто возвращает последнюю строку результата выполнения команды. Если вам необходимо выполнить команду и передать все данные из команды непосредственно обратно без изменения, используйте функцию passthru().

Если имеется аргумент array, то специфицированный массив заполняется строками вывода команды. Заметьте, что, если массив уже содержит некоторые элементы, exec() будет присоединять в конец массива. Если вы не хотите, чтобы эта функция присоединяла элементы, вызовите unset() в массиве до передачи его в exec().

Если имеется аргумент return_var, наряду с аргументом array, то return-статус выполняемой команды будет записан в эту переменную.

Предупреждение!Если вы разрешаете передачу данных от пользователя в эту функцию, то должны использовать escapeshellarg() или escapeshellcmd(), чтобы гарантировать, что пользователь не сможет заставить вашу ОС выполнять произвольные команды.

Примечание: Если ваша программа начинается с выполнения этой функции и хотите оставить её работать в фоновом режиме, вы должны убедиться, что вывод этой программы будет направлен в файл или в какой-нибудь другой поток вывода, иначе PHP зависнет, пока выполнение программы не закончится.

См. также system(), passthru(), popen(), escapeshellcmd() и операцию backtick.

exif_imagetype

(только PHP 4 CVS)

exif_imagetype - определяет тип изображения.

Описание

int|false exif_imagetype (string filename)

exif_imagetype() читает первые байты изображения и проверяет его подпись. Если корректная подпись найдена, возвращается константа, иначе возвращается FALSE. Возвращается то же значение, что и из getimagesize() в индексе 2, но эта функция работает намного быстрее.

Определены следующие константы: 1 = IMAGETYPE_GIF, 2 = IMAGETYPE_JPG, 3 = IMAGETYPE_PNG, 4 = IMAGETYPE_SWF, 5 = IMAGETYPE_PSD, 6 = IMAGETYPE_BMP, 7 = IMAGETYPE_TIFF_II (intel byte order),
8 = IMAGETYPE_TIFF_MM (motorola byte order), 9 = IMAGETYPE_JPC, 10 = IMAGETYPE_JP2, 11 = IMAGETYPE_JPX.

Эта функция может использоваться для исключения других exif-функций с неподдерживаемыми типами файлов или в сочетании с $_SERVER['HTTP_ACCEPT'] для проверки того, может ли зритель видеть данное конкретное изображение в своём браузере.

Примечание: эта функция доступна только в PHP 4, скомпилированном с --enable-exif.

Эта функция не требует наличия библиотеки GD image.

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

exif_read_data

(PHP 4 >= 4.2.0)

exif_read_data - читает шапки EXIF из JPEG или TIFF.

Описание

array exif_read_data (string filename [, string sections [, bool arrays [, bool thumbnail]]])

Функция exif_read_data() читает шапки/headers EXIF из файла изображения JPEG или TIFF. Она возвращает ассоциативный массив, где индексами являются header-имена, а значениями - значения, ассоциированные с этими headers. Если никакие данные не могут быть возвращены, возвращается FALSE.

filename это имя читаемого файла. Это не может быть url.

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

exif_thumbnail

(PHP 4 >= 4.2.0)

exif_thumbnail - запрашивает внедрённый уменьшенный вариант/thumbnail изображения TIFF или JPEG.

Описание

string exif_thumbnail (string filename [, int &width [, int &height]])

exif_thumbnail() читает внедрённое thumbnail изображения TIFF или JPEG. Если изображение не содержит thumbnail, возвращается FALSE.

Параметры width и height доступны, начиная с версии PHP 4.3, и возвращают размер thumbnail. Возможно, что exif_thumbnail() не сможет создать изображение, но определит его размер. В этом случае return-значением будет FALSE, но width и height устанавливаются.

Начиная с версии PHP 4.3, функция exif_thumbnail() может возвращать малые копии/thumbnails в формате TIFF.

Примечание: эта функция доступна только в PHP 4, скомпилированном с опцией
--enable-exif. Её функциональность и поведение изменились в PHP 4.2

Эта функция не требует библиотеки GD image.

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

exit

(unknown)

exit - выводит сообщение и прекращает выполнение текущего скрипта.

Описание

void exit ([string status])

void exit (int status)

Примечание: в действительности это не функция, а конструкция языка.

Функция exit() заканчивает выполнение скрипта. Она печатает status непосредственно перед выходом.

Если status это integer, это значение также будет использовано как статус выхода/exit status. Статус выхода должен быть в диапазоне от 1 до 254, статус 255 зарезервирован PHP и не должен использоваться.

Примечание: текущая версия CVS НЕ печатает status, если это integer.

Примечание: функция die() это псевдоним exit().

exp

(PHP 3, PHP 4)

exp - e в степени ...

Описание

float exp (float arg)

Возвращает e, возведённое в степень arg.

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

explode

(PHP 3, PHP 4)

explode - делит строку на строки.

Описание

array explode (string separator, string string [, int limit])

Возвращает массив строк, каждая из которых является подстрокой строки string и сформирована путём разделения строки по границам образованными сепаратором строки separator. Если limit установлен, возвращаемый массив будет содержать максимум элементов limit с последним элементом, содержащим остаток string.

Если separator это пустая строка (""), explode() возвратит FALSE. Если separator содержит значение, которое не содержится в строке string, то explode() возвратит массив, содержащий string.

Примечание: параметр limit был введён в PHP4.0.1.

Пример 1. explode()

$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza);
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user,$pass,$uid,$gid,$gecos,$home,$shell) = explode(":",$data);

Примечание: хотя implode() может, по историческим соображениям, принимать свои параметры в любом порядке, explode() не может. Вы обязаны гарантировать, что аргумент separator вводится до аргумента string.

См. также preg_split(), spliti(), split() и implode().

expm1

(PHP 4 >= 4.1.0)

expm1 - возвращает exp(number) - 1, высчитанное способом, обеспечивающим точность, даже если значение близко к нулю.

Описание

float expm1 (float number)

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

extension_loaded

(PHP 3>= 3.0.10, PHP 4)

extension_loaded - определяет, загружено ли расширение.

Описание

bool extension_loaded (string name)

Возвращает TRUE, расширение, идентифицированное name, загружено, FALSE в ином случае.

Пример:

extract

(PHP 3>= 3.0.7, PHP 4)

extract - импортирует переменные в текущую таблицу символов из массива.

Описание

int extract (array var_array [, int extract_type [, string prefix]])

Эта функция используется для импорта переменных из массива в текущую таблицу символов. Она принимает ассоциативный массив var_array и рассматривает ключи как имена переменных, а значения - как значения. Для каждой пары key/value она создаёт переменную в текущей таблице символов - субъект параметров extract_type и prefix.

Примечание: начиная с версии 4.0.5, эта функция возвращает количество извлечённых переменных.

Примечание: EXTR_IF_EXISTS и EXTR_PREFIX_IF_EXISTS были введены в версии 4.2.0.

extract() проверяет каждый ключ/key - образует ли он верное имя переменной, а также смотрит, нет ли конфликтов с существующими именами в таблице символов. Способ, которым обрабатываются неверные/числовые ключи и конфликты, определяется в extract_type. Это может быть одно из следующих значений:

EXTR_OVERWRITE

Если есть конфликт, существующая переменная перезаписывается.

EXTR_SKIP

Если есть конфликт, существующая переменная не перезаписывается.

EXTR_PREFIX_SAME

Если есть конфликт, вставить префикс prefix перед именем переменной.

EXTR_PREFIX_ALL

Вставить префикс prefix перед всеми именами переменных. Начиная с версии PHP 4.0.5, это могут быть также и числа.

EXTR_PREFIX_INVALID

Вводить префикс prefix только перед неправильными/числовыми именами переменных. Этот флаг был добавлен в PHP 4.0.5.

EXTR_IF_EXISTS

Перезаписывать переменную, только если она уже существует в текущей таблице символов, иначе - не делать ничего. Это используется для определения списка правильных переменных и последующего извлечения только тех переменных, которые вы определили вне $_REQUEST, например. Этот флаг был добавлен в PHP 4.2.0.

EXTR_PREFIX_IF_EXISTS

Создавать префиксированные имена переменных только с том случае, если версия без префикса той же самой переменной существует в текущей таблице символов. Этот флаг был добавлен в PHP 4.2.0.

Если extract_type не специфицирован, принимается, что он будет EXTR_OVERWRITE.

Заметьте, что prefix необходим только тогда, когда extract_type равен EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID или EXTR_PREFIX_IF_EXISTS. Если результат с префиксом не является правильным именем переменной, он не импортируется в таблицу символов.

extract() возвращает количество переменных, успешно импортированных в таблицу символов.

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

Пример 1. extract()

ezmlm_hash

(PHP 3>= 3.0.17, PHP 4 >= 4.0.2)

ezmlm_hash - вычисляет значение хэша, нужное для EZMLM.

Описание

int ezmlm_hash (string addr)

ezmlm_hash() вычисляет значение хэша, необходимое при сохранении почтовых списков рассылки EZMLM в БД MySQL.

fbsql_affected_rows

(PHP 4 >= 4.0.6)

fbsql_affected_rows - получает количество рядов, задействованных в предыдущей FrontBase-операции.

Описание

int fbsql_affected_rows ([resource link_identifier])

fbsql_affected_rows() возвращает количество рядов, задействованных в последнем запросе INSERT, UPDATE или DELETE, ассоциированном с link_identifier. Если link identifier/идентификатор ссылки не специфицирован, используется последняя ссылка, открытая функцией fbsql_connect().

Примечание: если вы используете транзакции, вы должны вызывать fbsql_affected_rows() после запроса INSERT, UPDATE или DELETE, а не после подтверждения транзакции.

Если последним был запрос DELETE без оператора WHERE, то все записи будут удалены из таблицы, а функция вернёт нуль.

Примечание: при использовании UPDATE, FrontBase не будет обновлять столбцы, где новая переменная - такая же, как и старая. Это может создать ситуацию, когда fbsql_affected_rows() может в действительности равняться не количеству совпавших рядов, а количеству рядов, которые действительно были задействованы в запросе.

Если последний запрос потерпел неудачу, эта функция возвратит -1.

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

fbsql_autocommit

(PHP 4 >= 4.0.6)

fbsql_autocommit - включает или отключает autocommit/автоподтверждение.

Описание

bool fbsql_autocommit (resource link_identifier [, bool OnOff])

fbsql_autocommit() возвращает текущий статус autocommit. Если задан необязательный параметр OnOff, статус автоподтверждения будет изменён. С OnOff, установленным в TRUE, каждый оператор (транзакции БД) будет подтверждаться автоматически, если нет ошибок. Если OnOff установлен в FALSE, пользователь обязан подтверждать или откатывать транзакции, используя fbsql_commit() или fbsql_rollback().

См. также fbsql_commit() и fbsql_rollback().

fbsql_change_user

(unknown)

fbsql_change_user - изменяет вошедшего пользователя активного соединения.

Описание

resource fbsql_change_user (string user, string password [, string database [, resource link_identifier]])

fbsql_change_user() изменяет вошедшего пользователя текущего активного соединения или соединения, заданного необязательным параметром link_identifier. Если БД database специфицирована, по умолчанию это будет она, либо текущая БД, после изменения пользователя. Если авторизация нового пользователя и пароля потерпела неудачу, остаётся активным текущий соединённый пользователь.

fbsql_close

(PHP 4 >= 4.0.6)

fbsql_close - закрывает FrontBase-соединение.

Описание

boolean fbsql_close ([resource link_identifier])

Возвращает: TRUE при успехе, FALSE при ошибке.

fbsql_close() закрывает соединение с FrontBase-сервером, ассоциированным со специфицированным идентификатором ссылки/link identifier. Если link_identifier не специфицирован, используется последняя открытая ссылка.

Использовать fbsql_close() обычно не нужно, так как непостоянные открытые ссылки автоматически закрываются в конце выполнения скрипта.

fbsql_commit

(PHP 4 >= 4.0.6)

fbsql_commit - подтверждает транзакцию БД.

Описание

bool fbsql_commit ([resource link_identifier])

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

fbsql_commit() заканчивает текущую транзакцию, записывает все вставленные данные обновления и удаления на диск и разблокирует все ряды и таблицы, блокированные этой транзакцией. Эта команда необходима, только если autocommit установлено в false.

См. также fbsql_autocommit() и fbsql_rollback().

fbsql_connect

(PHP 4 >= 4.0.6)

fbsql_connect - открывает соединение с FrontBase-сервером.

Описание

resource fbsql_connect ([string hostname [, string username [, string password]]])

Возвращает положительный идентификатор ссылки FrontBase при успехе, либо сообщение об ошибке - при неудаче.

fbsql_connect() устанавливает соединение с сервером FrontBase. Следующие значения по умолчанию принимаются для отсутствующих необязательных параметров: hostname = 'NULL', username = '_SYSTEM' и password = пустой пароль.

Если выполняется второй вызов fbsql_connect() с теми же самыми аргументами, новая ссылка не устанавливается, и возвращается link identifier уже открытой ссылки.

Ссылка на сервер будет закрыта сразу по окончании выполнения скрипта, если только она уже не будет ранее явно закрыта вызовом функции fbsql_close().

fbsql_create_blob

(PHP 4 >= 4.2.0)

fbsql_create_blob - создаёт BLOB.

Описание

string fbsql_create_blob (string blob_data [, resource link_identifier])

Возвращает: Дескриптор ресурса для вновь созданного blob.

fbsql_create_blob() создаёт blob из blob_data. Возвращаемый дескриптор ресурса может использоваться с командами insert и update для сохранения blob в БД.

fbsql_create_clob

(PHP 4 >= 4.2.0)

fbsql_create_clob - создаёт CLOB.

Описание

string fbsql_create_clob (string clob_data [, resource link_identifier])

Возвращает дескриптор ресурса для вновь созданного CLOB.

fbsql_create_clob() создаёт clob из clob_data. Возвращаемый дескриптор ресурса может использоваться с командами insert и update для сохранения clob в БД.

fbsql_create_db

(PHP 4 >= 4.0.6)

fbsql_create_db - создаёт БД FrontBase.

Описание

bool fbsql_create_db (string database name [, resource link_identifier])

fbsql_create_db() пытается создать новую БД на сервере, ассоциированном со специфицированным идентификатором ссылки.

fbsql_data_seek

(PHP 4 >= 4.0.6)

fbsql_data_seek - перемещает внутренний результирующий указатель.

Описание

bool fbsql_data_seek (resource result_identifier, int row_number)

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

fbsql_data_seek() перемещает внутренний указатель ряда FrontBase-результата, ассоциированного со специальным результирующим идентификатором, указывающим на номер специфицированного ряда. Последующий вызов fbsql_fetch_row() может возвратить этот ряд.

Row_number начинается с 0.

fbsql_database

(PHP 4 >= 4.0.6)

fbsql_database - получает или устанавливает имя БД, используемое в соединении.

Описание

string fbsql_database (resource link_identifier [, string database])

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

fbsql_database_password

(PHP 4 >= 4.0.6)

fbsql_database_password - устанавливает или запрашивает пароль для БД FrontBase.

Описание

string fbsql_database_password (resource link_identifier [, string database_password])

Возвращает пароль БД, ассоциированный с идентификатором ссылки.

fbsql_database_password() устанавливает и запрашивает пароль БД, используемый при соединении. Если БД защищена паролем, пользователь обязан вызвать эту функцию до вызова fbsql_select_db(). Если задан второй необязательный параметр, функция устанавливает пароль БД для специфицированного идентификатора ссылки. Если идентификатор ссылки не специфицирован, принимается последняя открытая ссылка. Если ни одной ссылки не открыта, функция попытается установить ссылку, как если бы была вызвана fbsql_connect(), и использовать её.

Эта функция не изменяет пароль в БД и не может использоваться для запрашивания пароля БД.

fbsql_db_query

(PHP 4 >= 4.0.6)

fbsql_db_query - отправляет FrontBase query/запрос.

Описание

resource fbsql_db_query (string database, string query [, resource link_identifier])

Возвращает положительный результирующий идентификатор FrontBase для результата запроса или FALSE при ошибке.

fbsql_db_query() выбирает БД и выполняет запрос к ней. Если необязательный идентификатор ссылки не предоставлен, функция пытается найти открытую ссылку на FrontBase-сервер и, если такой ссылки нет, пытается создать ссылку, как при вызове fbsql_connect() без аргументов.

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

fbsql_db_status

(PHP 4 >= 4.1.0)

fbsql_db_status - получает статус данной БД.

Описание

int fbsql_db_status (string database_name [, resource link_identifier])

Возвращает: целочисленное значение - текущий статус.

fbsql_db_status() запрашивает текущий статус БД, специфицированный параметром database_name. Если link_identifier отсутствует, используется link_identifier по умолчанию.

return-значением может быть одна из следующих констант:

FALSE - exec-обработчик для данного хоста был неправильным. Эта ошибка возникает, когда link_identifier соединяется непосредственно с БД с использованием номера порта. FBExec может иметься на сервере, но для него не было установлено соединение.

FBSQL_UNKNOWN - статус не известен.

FBSQL_STOPPED - БД не работает. Используйте fbsql_start_db() для старта БД.

FBSQL_STARTING - БД стартовала.

FBSQL_RUNNING - БД запущена и может использоваться для выполнения SQL-операций.

FBSQL_STOPPING - БД остановлена.

FBSQL_NOEXEC - FBExec не запущен на сервере, и невозможно получить статус БД.

См. также fbsql_start_db() и fbsql_stop_db().

fbsql_drop_db

(PHP 4 >= 4.0.6)

fbsql_drop_db - удаляет БД FrontBase.

Описание

bool fbsql_drop_db (string database_name [, resource link_identifier])

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

fbsql_drop_db() пытается удалить всю БД с сервера, ассоциированного со специфицированным идентификатором ссылки.

fbsql_errno

(PHP 4 >= 4.0.6)

fbsql_errno - возвращает числовое значение сообщения об ошибке в предыдущей операции FrontBase.

Описание

int fbsql_errno ([resource link_identifier])

Возвращает номер ошибки из последней fbsql-функции или 0 (нуль), если ошибки не было.

Ошибки, возвращаемые обратно из fbsql-БД, не выдают предупреждений. Вместо этого используйте fbsql_errno() для запрашивания кода ошибки. Заметьте, что эта функция возвращает только код ошибки из последней выполненной fbsql-функции (не включая fbsql_error() и fbsql_errno()), поэтому, если вы хотите её использовать, проверяйте значение перед вызовом другой fbsql.

fbsql_error

(PHP 4 >= 4.0.6)

fbsql_error - возвращает текст сообщения об ошибке предыдущей FrontBase-операции.

Описание

string fbsql_error ([resource link_identifier])

Возвращает текст об ошибке при выполнении последней fbsql-функции или '' (пустую строку), если ошибки не было.

Ошибки, возвращаемые обратно из fbsql-БД, не выдают предупреждений. Используйте fbsql_error() для получения текста ошибки. Заметьте, что эта функция возвращает только текст ошибки самой последней выполненной fbsql-функции (не включая fbsql_error() и fbsql_errno()), поэтому, если вы хотите использовать её, проверяйте значение перед вызовом следующей fbsql.

fbsql_fetch_array

(PHP 4 >= 4.0.6)

fbsql_fetch_array - извлекает результирующий ряд как ассоциативный массив, числовой массив или и тот и другой.

Описание

array fbsql_fetch_array (resource result [, int result_type])

Возвращает массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.

fbsql_fetch_array() это расширенная версия fbsql_fetch_row(). В дополнение к сохранению данных в числовых индексах результирующего массива, она также хранит данные в ассоциативных индексах, используя имена полей в качестве ключей.

Если два или более столбцов в результате имеют одинаковые имена, преимущество имеет последний столбец. Для доступа к другому столбцу (столбцам) с тем же именем вы обязаны использовать числовой индекс столбца или создать для столбца псевдоним.

fbsql_fetch_assoc

(PHP 4 >= 4.0.6)

fbsql_fetch_assoc - извлекает результирующий ряд как ассоциативный массив.

Описание

array fbsql_fetch_assoc (resource result)

Возвращает ассоциативный массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.

fbsql_fetch_assoc() эквивалентен вызову fbsql_fetch_array() с FBSQL_ASSOC в качестве второго необязательного параметра. Возвращает только ассоциативный массив. Это изначальный способ работы fbsql_fetch_array(). Если вам нужны не только ассоциативные, но и числовые индексы, используйте fbsql_fetch_array().

Если два или более столбцов в результате имеют одинаковые имена, преимущество имеет последний столбец. Для доступа к другому столбцу (столбцам) с тем же именем вы обязаны использовать fbsql_fetch_array() и заставить её возвращать также и числовые индексы.

Важно отметить, что использование fbsql_fetch_assoc() НЕНАМНОГО медленнее, чем fbsql_fetch_row(), но предоставляет важное дополнительное значение.

Детали см. в fbsql_fetch_row() и fbsql_fetch_array().

fbsql_fetch_field

(PHP 4 >= 4.0.6)

fbsql_fetch_field - получает информацию столбца из результата и возвращает её как объект.

Описание

object fbsql_fetch_field (resource result [, int field_offset])

Возвращает объект, содержащий информацию поля.

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

Свойства объекта:

name - имя столбца

table - имя таблицы, которой принадлежит столбец

max_length - максимальный размер столбца

not_null - 1, если столбец не может быть NULL

type - тип столбца

Пример 1. fbsql_fetch_field()

fbsql_fetch_lengths

(PHP 4 >= 4.0.6)

fbsql_fetch_lengths - получает длину каждого вывода в результате.

Описание

array fbsql_fetch_lengths ([resource result])

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

fbsql_fetch_lengths() хранит размеры каждого результирующего столбца в последнем ряду, возвращённом fbsql_fetch_row(), fbsql_fetch_array() и fbsql_fetch_object() в массиве, начиная со смещения 0.

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

fbsql_fetch_object

(PHP 4 >= 4.0.6)

fbsql_fetch_object - извлекает результирующий ряд как объект.

Описание

object fbsql_fetch_object (resource result [, int result_type])

Возвращает объект со свойствами, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.

fbsql_fetch_object() напоминает fbsql_fetch_array(), но с одним отличием - возвращается объект вместо массива. Неявно, что означает, что вы можете получить доступ к данным только по именам полей, но не по их смещениям (числая являются недопустимыми именами свойств).

Необязательный аргумент result_type это константа, имеющая следующие значения: FBSQL_ASSOC, FBSQL_NUM и FBSQL_BOTH.

По скорости эта функция идентична fbsql_fetch_array() и почти не уступает fbsql_fetch_row() (разница несущественна).

fbsql_fetch_row

(PHP 4 >= 4.0.6)

fbsql_fetch_row - получает результирующий ряд как перечислимый массив.

Описание

array fbsql_fetch_row (resource result)

Возвращает: массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.

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

Последующий вызов fbsql_fetch_row() может возвратить следующий ряд результирующего набора или FALSE, если рядов больше нет.

См. также fbsql_fetch_array(), fbsql_fetch_object(), fbsql_data_seek(), fbsql_fetch_lengths() и fbsql_result().

fbsql_field_flags

(PHP 4 >= 4.0.6)

fbsql_field_flags - получает флаги, ассоциированные с со специфицированным полем в результате.

Описание

string fbsql_field_flags (resource result, int field_offset)

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

fbsql_field_len

(PHP 4 >= 4.0.6)

fbsql_field_len - возвращает длину специфицированного поля.

Описание

int fbsql_field_len (resource result, int field_offset)

fbsql_field_len() возвращает длину специфицированного поля.

fbsql_field_name

(PHP 4 >= 4.0.6)

fbsql_field_name - получает имя специфицированного поля в результате.

Описание

string fbsql_field_name (resource result, int field_index)

fbsql_field_name() возвращает специфицированного индекса поля.
result обязан быть правильным идентификатором результата, а field_index это числовое смещение поля.

Примечание: field_index стартует с 0, например, индекс третьего поля это 2, индекс четвёртого - 3 и т.д.

fbsql_field_seek

(PHP 4 >= 4.0.6)

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

Описание

bool fbsql_field_seek (resource result, int field_offset)

Ищет специфицированное смещение поля. Если последующий вызов fbsql_fetch_field() не содержит смещения поля, будет возвращено смещение, специфицированное в fbsql_field_seek().

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

fbsql_field_table

(PHP 4 >= 4.0.6)

fbsql_field_table - получает имя таблицы, в которой находится специфицированное поле.

Описание

string fbsql_field_table (resource result, int field_offset)

Возвращает имя таблицы, в которой находится специфицированное поле.

fbsql_field_type

(PHP 4 >= 4.0.6)

fbsql_field_type - получает тип специфицированного поля в результате.

Описание

string fbsql_field_type (resource result, int field_offset)

fbsql_field_type() похожа на fbsql_field_name(). Аргументы идентичны, но возвращается тип поля. Он имеет одно из следующих значений: "int", "real", "string", "blob" и другие, как детализировано в документации FrontBase.

fbsql_free_result

(PHP 4 >= 4.0.6)

fbsql_free_result - освобождает результирующую память.

Описание

bool fbsql_free_result (resource result)

fbsql_free_result() освободит результирующую память, ассоциированную с идентификатором результата result.

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

fbsql_get_autostart_info

(PHP 4 >= 4.1.0)

fbsql_get_autostart_info - описания пока нет.

Описание

array fbsql_get_autostart_info ([resource link_identifier])

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

fbsql_hostname

(PHP 4 >= 4.0.6)

fbsql_hostname - получает или устанавливает имя хоста, используемое при соединении.

Описание

string fbsql_hostname (resource link_identifier [, string host_name])

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

fbsql_insert_id

(PHP 4 >= 4.0.6)

fbsql_insert_id - получает id, сгенерированный предыдущей операцией INSERT.

Описание

int fbsql_insert_id ([resource link_identifier])

fbsql_insert_id() возвращает ID, сгенерированный для столбца, определённого как DEFAULT UNIQUE предыдущим запросом INSERT, с использованием данного link_identifier. Если link_identifier не специфицирован, принимается последняя открытая ссылка.

fbsql_insert_id() возвращает 0, если предыдущий запрос не генерирует значение DEFAULT UNIQUE. Если вам нужно сохранить значение на будущее, вызовите fbsql_insert_id() сразу после запроса, генерирующего это значение.

Примечание: значение FrontBase SQL-функции LAST_INSERT_ID() всегда содержит самое последнее сгенерированное DEFAULT UNIQUE и не восстанавливается между запросами.

fbsql_list_dbs

(PHP 4 >= 4.0.6)

fbsql_list_dbs - список БД, доступных на FrontBase-сервере.

Описание

resource fbsql_list_dbs ([resource link_identifier])

fbsql_list_dbs() возвращает результирующий указатель, содержащий базы данных, доступные на текущем fbsql-демоне. Используйте fbsql_tablename() для прохода этим указателем результата.

fbsql_list_fields

(PHP 4 >= 4.0.6)

fbsql_list_fields - список результирующих полей FrontBase.

Описание

resource fbsql_list_fields (string database_name, string table_name [, resource link_identifier])

fbsql_list_fields() возвращает информацию о данной таблице tablename. Аргументами являются имя БД и имя таблицы. Возвращается результирующий указатель, который можно использовать с функциями fbsql_field_flags(), fbsql_field_len(), fbsql_field_name() и fbsql_field_type().

Результирующий идентификатор это положительное целое число. Функция возвращает -1, если возникла ошибка. Строка с описанием ошибки помещается в $phperrmsg, и, если функция не была вызвана как @fbsql(), то эта строка ошибки также будет напечатана.

Пример 1. fbsql_list_fields()

fbsql_list_tables

(PHP 4 >= 4.0.6)

fbsql_list_tables - список таблиц во FrontBase-БД.

Описание

resource fbsql_list_tables (string database [, resource link_identifier])

fbsql_list_tables() принимает имя БД и возвращает результирующий указатель, как и функция fbsql_db_query(). Функция fbsql_tablename() должна использоваться для извлечения реальных имён таблиц из результирующего указателя.

fbsql_next_result

(PHP 4 >= 4.0.6)

fbsql_next_result - перемещает внутренний указатель результата на следующий результат.

Описание

bool fbsql_next_result (resource result_id)

Отправка более одного оператора SQL на сервер или выполнение хранимой процедуры с несколькими результатами заставляет сервер возвращать несколько результирующих наборов. Эта функция тестирует  на наличие дополнительных результатов, имеющихся на сервере. Если дополнительный результирующий набор имеется, она освобождает имеющийся результирующий набор и готовится к извлечению слов из нового результирующего набора. Функция возвращает TRUE, если дополнительный результирующий набор был доступен, и FALSE в противном случае.

---

---