Руководство по РНР 3.0

a89ae562

возвращает строку, содержащую имя типа



Описание

int pg_fieldtype(int result_id, int field_number); pg_FieldType() возвращает строку, содержащую имя типа указанного поля в указанном идентификаторе результата PosgreSQL. Нумерация полей начинается с 0.

Описание

int pg_freeresult(int result_id); pg_FreeResult() необходимо использовать только если вы беспокоитесь об использовании слишком большего объема памяти при работе вашего скрипта. Вся память резульата будет автоматически освобождена при завершении работы скрипта. Но, если вы уверены, что вам больше не потребуется память результата в скрипте, то вы можете вызвать pg_FreeResult(), с идентификатором результата в качестве параметра, и соответствующая память результата будет освобождена.



Описание

int pg_getlastoid(int result_id); pg_GetLastOid() может быть использована для получения идентификатора, присвоенного запросу на вставку, если идентификатор результата использовался последней командой pg_Exec() и это была команда SQL INSERT. Эта функция вернет положительное целое число, если это был верный идентификатор. Функция вернет -1, если произошла ошибка или последня команда pg_Exec() не была INSERT.





Описание

string pg_host(int connection_id); pg_Host() возвращает имя узла, с которым соединен указанный идентификатор соединения PostgreSQL.



Описание

void pg_loclose(int fd); pg_loclose() закрывает отображение большого объекта (ILO). fd является дескриптором файла для большого объекта из pg_loopen().



Описание

int pg_locreate(int conn); pg_locreate() создает отображение большого объекта (ILO) и возвращает идентификатор большого объекта. conn определяет верное соединение с базой данных. Режимы доступа PostgreSQL INV_READ, INV_WRITE, и INV_ARCHIVE не поддерживаются, объект создается всегда и для чтения и для записи. INV_ARCHIVE был удален из самой PostgreSQL (версии 6.3 и выше).



Описание

int pg_loopen( int conn, int objoid, string mode); pg_loopen() открывает отображение большого объекта (ILO) и возвращает дескриптор файла большого объекта. Дескриптор файла содержит информацию о соединении. Не закрывайте соединение до закрытия дескриптора файла большого объекта. objoid определяет верный идентификатор большого объекта и mode может быть одним из "r", "w", or "rw".



Описание

string pg_loread(int fd, int len); pg_loread() считывает len байтов из большого объекта и возвращает их в виде строки. fd определяет верный декскриптор файла большого объекта len определяет максимально возможный размер сегмента большого объекта.



Описание

void pg_loreadall(int fd); pg_loreadall() считывает большой объект и отправляет его прямо в броузер, после всех необходимых заголовков. В основном применяется для отправки двоичных данных, таких как изображения и звуковые файлы.



Описание

void pg_lounlink( int conn, int lobjid); pg_lounlink() удаляет большой объект с идентификатором большого объекта lobjid.



Описание

int pg_lowrite(int fd, string buf); pg_lowrite() записывает данные в большой объект из переменной buf и возвращает число записанных данных или false при ошибке. fd является дескриптором файла большого объекта из функции pg_loopen().



Описание

int pg_numfields(int result_id); pg_NumFields() возвращает количестов полей (столбцов) в результате PostgreSQL. Параметр является верным идентификатором результата, полученным функцией pg_Exec(). Эта функция вернет -1 при ошибке.



Описание

int pg_numrows(int result_id); pg_NumRows() возвращает число записей в результате PostgreSQL. Параметр является верным идентификатором результата, полученным функцией pg_Exec(). Эта функция вернет -1 при ошибке.



Описание

string pg_options(int connection_id); pg_Options() возвращает строку, содержащую настройки, соответствующие указанному идентификатору соединения PostgreSQL.



Описание

int pg_pconnect( string host, string port, string options, string tty, string dbname); Возвращает номер соединения при успехе или false, если соединение не может быть установлено. Открывает устойчивое соединение с базой данных PostgreSQL. Каждый параметр должен быть строкой в кавычках, включая номер порта. Параметры options и tty являются дополнительными и могут быть опущены. Эта функция возвращает номер соединения, который необходим другим функциям PostgreSQL. Вы можете одновременно открыть несколько устойчивых соединений. См. также pg_Connect(). Соединение может также быть установлено следующей командой: $conn = pg_pconnect("dbname=marliese port=5432"); Остальные параметры, кроме dbname и port, - это host, tty и options.



Описание

int pg_port(int connection_id); pg_Port() возвращает номер порта, с которым соединен указанный идентификатор соединения PostgreSQL.



Описание

mixed pg_result( int result_id, int row_number, mixed fieldname); pg_Result() возвращает данные из идентификатора результата, полученного pg_Exec(). Параметры row_number и fieldname определяют, из какой ячейки таблицы будут взяты данные. Нумерация записей и полей начинается с 0. Вместо имени поля вы можете использовать номер поля (без кавычек). PostgreSQL имеет много видов данных, но здесь поддерживаются только основные. Все виды целых и логических типов, типов идентификаторов возвращаются как целые числа. Все виды типов с плавающей точкой и действительных чисел возвращаются как тип double. Все осталные типы, включая массивы возвращаются как строки, отформатированные в том же виде, какой вы видели в программе psql.



Описание

string pg_tty(int connection_id); pg_tty() возвращает имя tty, которое сервер дает указанному идентификатору соединения PostgreSQL.  



Описание

int ereg( string pattern, string string, array [regs]); Ищет парные значения string в регулярном выражении, указанном в pattern. Если парные значения найдены для подстрок в круглых скобках pattern и функция вызывалась с третьим аргументом regs, то парные значения будут сохранены в элементах regs. $regs[1] будет содержать подстроку, которая начинается с первой левой круглой скобки; $regs[2] будет содержать подстроку, начинающуюся со второй скобки и т.д. $regs[0] будет содержать копию string. Поиск чуствителен к регистру. Функция возвращает true, если парное значение для pattern было найдено в string, или false, если не было найдено парных значений или произошла ошибка. Следующий код извлекает дату в ISO формате и выводит в формате DD.MM.YYYY:
Example 1. ereg() exampleif ( ereg( "([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs ) ) { echo "$regs[3].$regs[2].$regs[1]"; } else { echo "Invalid date format: $date"; }
См. также eregi(), ereg_replace(), и eregi_replace().



Описание

string ereg_replace( string pattern, string replacement, string string); Эта функция сканирует string на парные значения к pattern, затем заменяет найденный текст на replacement. Если pattern содержит подстроки в круглых скобках, тоreplacement может содержать подстроки вида \\цифра, которые будут заменены текстом, совпадающим с цифровой подстрокой в скобках; \\0 обработает все содержимое строки. Может быть использовано до 9 подстрок. Скобки могут быть сгруппированы, в этом случае они считаются по открывающим скобкам. Например, следующий код напечатет "This was a test" три раза:



Описание

int eregi( string pattern, string string, array [regs]); Эта функция идентична ereg() , за исключением того, что она игнорирует различие в регистре у буквенных символов. См. также ereg(), ereg_replace(), и eregi_replace().



Описание

string eregi_replace( string pattern, string replacement, string string); Эта функция идентична ereg_replace() за исключением того, что она игнорирует различие в регистре у буквенных символов. См. также ereg(), eregi(), и ereg_replace().



Описание

array split( string pattern, string string, int [limit]); Возвращает массив строк, каждая из которых является подстрокой строки, образованные разбитием этой строки на части, отделенные друг от друга pattern. Если произойдет ошибка, функция вернет false. Для получения первых 5 полей из строки в /etc/passwd:



Описание

string sql_regcase(string string); Возвращает верное регулярное выражение, которое не будет соответствовать string, игнорирую регистр. Это выражение является string , каждый символ которой переводится в выражение с квадратными скобками; это выражение содержит символы исходной строки в верхнем и нижнем регистре, если это возможно, в противном случае дважды вставляется исходный символ.



Описание

int sem_get (int key, int [ max_acquire ] , int [ perm ] ); Возвращает положительный индентификатор семафора при успехе или false при ошибке. sem_get() возвращает идентификатор, который может быть использован для доступа к семафору System V с указанным ключом. Семафор создается, если необходимо, используя биты доступа, указанные в perm (по умолчанию 0666). Число процессов, которое может быть зафиксировано семафором одновременно устанавливается в max_acquire (по-умолчанию 1). В действительности это значение устанавливается только если процесс обнаруживает, что он является единственным, присоединенным к семафору. Повторный вызов функции sem_get() с тем же ключем вернет другой идентификатор семафора, но оба идентификатора указывают на один и тот же семафор. См. также: sem_acquire() and sem_release() .



Описание

int sem_acquire (int sem_identifier); Возвращает true при успехе, false при ошибке. sem_acquire() блокируется (если необходимо) до тех пор, пока семафор сможет быть зафиксирован. Процесс, пытающийся зафиксировать семафор, который уже зафиксирован, буде блокирован навсегда, если фиксация семафора вызовет превышение его max_acquire значения.. После обработки запроса, любые семафоры, зафиксированные процессом, но не освобожденные вручную, будут освобождены автоматически с выдачей предупреждения. См. также: sem_get() and sem_release() .



Описание

int sem_release (int sem_identifier); Возвращает true при успехе и false при ошибке. sem_release() освобождает семафор если он зафиксирован в данное время вызывающим процессом, иначе выдается предупреждение. После освобождения семафора функция sem_acquire() может быть вызвана для ре-фиксации его. См. также: sem_get() and sem_acquire() .



Описание

int shm_attach ( long key, long memsize, long perm); Создает или открывает разделяемую память с указанным ключем и размером памяти.



Описание

int shm_detach (long id); Отсоединяет от разделяемой памяти с указанным id , созданным с помощью функции shm_attach() . Помните, что разделяемая память все еще существует в Unix-системе и данные все еще присутствуют.



Описание

int shm_put_var ( int id, long variable_key, mixed variable); Вставляет или обновляет переменную с указанным variable_key. Все типы переменных (double, long, string, array) поддерживаются. Функция serialize() может быть использована для хранения данных.



Описание

mixed shm_get_var (int id, long variable_key); Считывает переменную с указанным variable_key . Переменная все еще присутствует в разделяемой памяти. Функция unserialize() может быть использована для декодирования данных.



Описание

int shm_remove_var ( int id, long variable_key); Удаляет переменную с указанным variable_key из разделяемой памяти.



Описание

int shm_remove (long key); Удаляет разделяемую память из Unix-системы. Все данные будут уничтожены.  



odbc_close()

См. odbc_close().



Описание

См. odbc_connect().



Описание

См. odbc_exec().



Описание

См. odbc_field_name().



Описание

См. odbc_field_num().



odbc_free_result()

См. odbc_free_result().



Описание

См. odbc_num_fields().



Описание

См. odbc_num_rows().



Описание

См. odbc_result().  



Описание

int snmpget ( string hostname, string community, string object_id); Возвращает значание SNMP объекта при успехе и false при ошибке. Функция snmpget() используется для чтения значения SNMP объекта, указанного в object_id. SNMP агент определяется именем хоста hostname и группа чтения определяется параметром community.

snmpget("127.0.0.1","public", "system.SysContact.0")



Описание

array snmpwalk ( string hostname, string community, string object_id); Возвращает массив значений SNMP объектов начиная с object_id и false при ошибке. Функция snmpwalk() используется для чтения всех значений у SNMP агента, определяемого параметром hostname. Community определяет группу чтения для агента. Нулевой object_id берется как корень дерева SNMP объектов и все объекты под этим деревом возвращаются как массив. Если object_id указан, то возвращаются все SNMP объекты ниже этого объекта. $a = snmpwalk("127.0.0.1", "public", ""); Указанный выше вызов функции вернет все SNMP объекты из SNMP агента, напущенного на локальном хосте. По всем значениям можно пройти с помощью цикла for($i=0; $i<count($a); $i++) { echo $a[$i]; }  



Описание

string addslashes(string str); Возвращает строку с обратной чертой (/) перед символами, которые должны быть выделены в запросах к базам данных и т.п. Эти символы: ('), двойные кавычки ("), (\) и NUL (нулевой байт). См. также stripslashes(), htmlspecialchars() и quotemeta().



Описание

string chop(string str); Возвращает строку без повторяющихся пробелов.

Example 1. chop()$trimmed = Chop($line);
См. также trim().



Описание

string chr(int ascii); возвращает односимвольную строку, содержащую символ, определенный кодом ascii.
Example 1. chr()$str .= chr(27); /* добавляет символ ESC в конец $str *//* Часто это более полезно */ $str = sprintf("The string ends in escape: %c", 27);
Эта функция дополняет функцию ord(). См. также sprintf() с форматирующей строкой %c.



Описание

string chunk_split(string string, int [chunklen] , string [end] ); Может быть использована для разбития строки на более меньшие части, например, при конвертировании результата функции base64_encode в формат RFC 2045. Функция вставляет каждый chunklen-ый (по умолчанию до 76) символ строку end (по умолчанию "\r\n"). Функция возвращает новую строку, оставляя исходную не тронутой.
Example 1. chr_replace()# format $data using RFC 2045 semantics$new_string = chunk_split(base64_encode($data));
Эта функция значительно быстрее, чем ereg_replace().



Описание

string convert_cyr_string( string str, string from, string to); Эта функция переводит указанную строку из одной русской кодовой таблицы в другую. Аргументы from и to являются одним символом, который определяет исходную и целевую кодовую таблицу. Поддерживаемые типы:
  • k - koi8-r
  • w - windows-1251
  • i - iso8859-5
  • a - x-cp866
  • d - x-cp866
  • m - x-mac-cyrillic




Описание

string crypt(string str, string [salt]); crypt() Зашифрует строку, используя стандартный метод шифрации UNIX DES. Аргументы являются строкой, которую нужно зашифровать, и дополнительная 2-символная строка salt, на которой будет основываться шифрование. См. документацию UNIX для дополнительной информации. Если аргумент salt отсутствует, то он буде генерирован случайным образом. Некоторые операционные системы поддерживают больше одного типа шифрования. В действительности, иногда метод шифрования DES заменятеся основанными на MD5 алгоритмами. Тип шифрования устанавливается аргументом salt. Во время установки PHP определяет возможности функций шифрации и будет поддерживать аргумент salt для других методов шифрации. Если параметр salt не установлен, то PHP автоматически сгенерирует стандартный 2-х символный ключ DES, если же в системе по умолчанию установлен тип шифрации MD5, то будет сгенерирован MD5-совместимый ключ. Стандартная шифрация DES crypt() содержит ключ в двух первых символах потока вывода. Нет других функций дешифрации, кроме crypt() использующей однопроходный алгоритм.



Описание

echo(string arg1, string [argn]...); Выводит все параметры. echo() в действительности не является функцией (это языковая конструкция), поэтому вам не обязательно использовать круглые скобки.



Описание

array explode(string separator, string string); Возвращает массив строк, содержащий в элементы, разделенные срокой separator.



Описание

void flush(void); Освобождает буферы вывода PHP и все остальные, использумые PHP (CGI, web-сарвер и т.д.). Это эффективная возможность выдать все накопленное в буферах в броузер пользователя.



Описание

array get_meta_tags(string filename, int [use_include_path]); Открывает файл filename и обрабатывает его строка за строкой и извлекает теги <meta>.



Описание

string htmlspecialchars(string string); Определенные символы имеют особое значение в HTML и должны быть заменены кодами HTML, если они таковые имеют. Эта функция возвращает строки с произведенными такими изменениями. Эта функция полезна для отчистки полученного от пользователя текста от разметки HTML (доски сообщений, гостевые книги). В настоящее время осуществляются следующие замены:
  • '&' (амперсанд) становится '&amp;'
  • '"' (двойные кавычки) становится '&quot;'
  • '<' (знак меньше) становится '&lt;'
  • '>' (знак больше) становится '&gt;'
Следует отметить, что эта функция не заменяет ничего, кроме указанного выше. Для полной обработки см. функцию htmlentities(). См. также htmlentities() и nl2br().



Описание

string htmlentities(string string); Эта функция идентична htmlspecialchars() , кроме того, что все символы, которые имеют соответсвующий код HTML заменяются на этот HTML код. В настоящее время применятеся кодовая таблица ISO-8859-1. См. также htmlspecialchars() и nl2br().



Описание

string implode(array pieces, string glue); Возвращает строку, содержащую совокупность всех элементов массива в том же порядке, со строкой glue между каждым элементом.



Описание

string join( array pieces, string glue); join() является псевдонимом функции implode(), и полностью ей идентична.



Описание

string ltrim(string str); Эта функция удаляет пробелы из начала строки и возвращает обрезаную строку. См. также chop() и trim().



Описание

string md5(string str); Вычисляет значение MD5 для строки str используя алгоритм RSA Data Security, Inc. MD5 Message-Digest.



Описание

string nl2br(string string); Возвращает string с '<BR>' вставляемыми перед каждой новой строкой. См. также htmlspecialchars() и htmlentities().



Описание

int ord(string string); Возвращает ASCII- значение первого символа строки string. Эта функция дополняет функцию chr().



Описание

void parse_str(string str); Разбирает строку str , как если бы она была URL-строкой запроса, и устанавливает переменные текущей среды.



Описание

print(string arg); Выводит строку arg. См. также: echo() printf() flush()



Описание

int printf(string format, mixed [args]...); Осуществляет вывод в соответствии с параметром format, который расписан в описании функции sprintf(). См. также: print(), sprintf(), и flush().



Описание

string quoted_printable_decode(string str); Эта функция возвращает 8- битную строку, соответствующую декодированной сроке в кавычках. Эта функция аналогична imap_qprint(), за исключением того, что она не требует IMAP модуль для работы.



Описание

int quotemeta(string str); Возвращает обработанную str с символами (\) перед каждым из следующих символов: . \\ + * ? [ ^ ] ( $ ) См. также addslashes(), htmlentities(), htmlspecialchars(), nl2br(), и stripslashes().



Описание

string rawurldecode(string str); Возвращает строку, в которой последовательность из символа процента (%) с последующих 2-х шестнадцатиричных цифр заменяется соответствующим буквенным символом. Например, строку foo%20bar%40baz будет заменена на foo bar@baz См. также rawurlencode().



Описание

string rawurlencode(string str); Возвращает строку, в которой все не буквенно-цифровые символы, кроме -_. заменяются на знак (%) с последующими двумя шестнадцатиричными цифрами. Это кодирование, описанное в RFC1738, применяется для защиты символов от интерпритации их как особых разделителей URL, и для защиты URL от искажения системами передачи данных с переводом символов (как некоторые e-mail системы). Например, если вы хотите включить пароль в ftp URL:

Содержание раздела