mysql_field_table

(PHP 3, PHP 4)

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

Описание

string mysql_field_table (resource result, int field_offset)

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

Для обеспечения обратной совместимости можно также использовать mysql_fieldtable(), но это не рекомендуется.

mysql_field_type

(PHP 3, PHP 4)

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

Описание

string mysql_field_type (resource result, int field_offset)

mysql_field_type() аналогична mysql_field_name(). Аргументы идентичны, но возвращается тип поля. Это может быть "int", "real", "string", "blob" и другие типы, как уточнено в MySQL-документации.

mysql_free_result

(PHP 3, PHP 4)

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

Описание

bool mysql_free_result (resource result)

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

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

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

Для обеспечения обратной совместимости можно также использовать mysql_freeresult(), но это не рекомендуется.

mysql_get_client_info

(PHP 4 >= 4.0.5)

mysql_get_client_info - получает информацию MySQL-клиента.

Описание

string mysql_get_client_info (void)

mysql_get_client_info() возвращает строку с версией клиентской библиотеки.

mysql_get_host_info

(PHP 4 >= 4.0.5)

mysql_get_host_info - получает информацию о MySQL-хосте.

Описание

string mysql_get_host_info ([resource link_identifier])

mysql_get_host_info() возвращает строку с описанием типа соединения, используемого с link_identifier, включая имя хоста сервера. Если link_identifier опущен, используется последнее открытое соединение.

mysql_get_proto_info

(PHP 4 >= 4.0.5)

mysql_get_proto_info - получает информацию о протоколе MySQL.

Описание

int mysql_get_proto_info ([resource link_identifier])

mysql_get_proto_info() возвращает версию протокола, используемого соединением link_identifier. Если link_identifier опущен, используется последнее открытое соединение.

mysql_get_server_info

(PHP 4 >= 4.0.5)

mysql_get_server_info - получает информацию о MySQL-сервере.

Описание

string mysql_get_server_info ([resource link_identifier])

mysql_get_server_info() возвращает версию сервера, используемого в соединении link_identifier. Если link_identifier опущен, используется последнее открытое соединение.

mysql_info

(только PHP 4 CVS)

mysql_info - получает информацию о самом последнем запросе.

Описание

string mysql_info ([resource link_identifier])

mysql_info() возвращает детальную информацию о последнем запросе с использованием данного идентификатора link_identifier. Если link_identifier не специфицирован, принимается последняя открытая ссылка.

mysql_info() возвращает строку со всеми операторами, перечисленными ниже. Для всех других - FALSE. Формат строки зависит от оператора.

mysql_insert_id

(PHP 3, PHP 4)

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

Описание

int mysql_insert_id ([resource link_identifier])

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

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

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

Предупреждение! mysql_insert_id() конвертирует return-тип внутренней MySQL C API-функции mysql_insert_id() в тип long (называемый в РНР int). Если ваш столбец AUTO_INCREMENT имеет тип столбца BIGINT, значение, возвращаемое функцией mysql_insert_id(), будет некорректным. Тогда используйте внутреннюю MySQL SQL-функцию LAST_INSERT_ID() в SQL-запросе.

mysql_list_dbs

(PHP 3, PHP 4)

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

Описание

resource mysql_list_dbs ([resource link_identifier])

mysql_list_dbs() возвращает результирующий указатель, содержащий базы данных, доступные с текущего mysql-демона. Используйте функцию mysql_tablename() для прохода по результирующему указателю, либо любую функцию для таблиц результатов.

mysql_list_fields

(PHP 3, PHP 4)

mysql_list_fields - список полей MySQL-результата.

Описание

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

mysql_list_fields() запрашивает информацию о данной таблице tablename. Аргументами являются имя БД и имя таблицы. Возвращаемый результирующий указатель может использоваться функциями mysql_field_flags(), mysql_field_len(), mysql_field_name() и mysql_field_type().

mysql_list_processes

(только PHP 4 CVS)

mysql_list_processes - список процессов MySQL.

Описание

resource mysql_list_processes ([resource link_identifier])

mysql_list_processes() возвращает результирующий указатель - описание текущих потоков сервера.

mysql_list_tables

(PHP 3, PHP 4)

mysql_list_tables - список таблиц БД MySQL.

Описание

resource mysql_list_tables (string database [, resource link_identifier])

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

Параметр database это имя БД, в которой запрашивается список таблиц. При неудаче mysql_list_tables() возвращает FALSE.

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

mysql_num_fields

(PHP 3, PHP 4)

mysql_num_fields - получает количество полей в результате.

Описание

int mysql_num_fields (resource result)

mysql_num_fields() возвращает количество полей в результирующем наборе.

См. также mysql_select_db(), mysql_query(), mysql_fetch_field(), mysql_num_rows().

Для обратной совместимости можно также использовать mysql_numfields(), но это не рекомендуется.

mysql_num_rows

(PHP 3, PHP 4)

mysql_num_rows - получает количество рядов в результате.

Описание

int mysql_num_rows (resource result)

mysql_num_rows() возвращает количество рядов в результирующем наборе. Эта команда верна только для операторов SELECT. Для запрашивания количества рядов, задействованных в запросах INSERT, UPDATE или DELETE, используйте mysql_affected_rows().

Пример 1. mysql_num_rows()

<?php
$link = mysql_connect("localhost", "mysql_user", "mysql_password");
mysql_select_db("database", $link);
$result = mysql_query("SELECT * FROM table1", $link);
$num_rows = mysql_num_rows($result);
echo "$num_rows Rows\n";
?>

Примечание: если вы используете mysql_unbuffered_query(), mysql_num_rows() не возвращает корректное значение, пока не будут запрошены все ряды результирующего набора.

См. также mysql_affected_rows(), mysql_connect(), mysql_data_seek(), mysql_select_db() и mysql_query().

Для обратной совместимости можно также использовать mysql_numrows(), но это не рекомендуется.

mysql_pconnect

(PHP 3, PHP 4)

mysql_pconnect - открывает постоянное соединение с MySQL-сервером.

Описание

resource mysql_pconnect ([string server [, string username [, string password]]])

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

mysql_pconnect() устанавливает соединение с MySQL-сервером. Следующие значения по умолчанию предусмотрены для опущенных необязательных параметров: server = 'localhost:3306', username = имя пользователя - владельца серверного процесса, password = пустой пароль.

Параметр server может также содержать номер порта, например, "hostname:port", или путь к сокету, например, ":/path/to/socket", для локального хоста.

Примечание: поддержка ":port" была добавлена в 3.0B4.

Поддержка ":/path/to/socket" была добавлена в 3.0.10.

mysql_pconnect() работает очень похоже на mysql_connect(), с двумя отличиями.

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

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

Ссылки этого типа называются поэтому 'persistent/постоянные'.

Примечание: обратите внимание, что ссылки это типа работают только тогда, когда вы используете модульную версию PHP. См. в разделе Постоянное соединение с БД дополнительную информацию.

Предупреждение!Использование постоянных соединений может потребовать некоторой настройки конфигурации Apache и MySQL, чтобы гарантировать, что вы не превысите количество соединений, допускаемых MySQL.

mysql_ping

(только PHP 4 CVS)

mysql_ping - посылает сигнал серверу для соединения или повторного соединения, если соединения нет.

Описание

bool mysql_ping ([resource link_identifier])

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

См. также mysql_thread_id(), mysql_list_processes().

mysql_query

(PHP 3, PHP 4)

mysql_query - отправляет MySQL-запрос/query.

Описание

resource mysql_query (string query [, resource link_identifier [, int result_mode]])

mysql_query() отправляет запрос текущей активной БД на сервере, ассоциированной со специфицированным идентификатором ссылки/link_identifier. Если link_identifier не специфицирован, принимается последняя открытая ссылка. Если такой ссылки нет, функция пытается установить ссылку, как при вызове mysql_connect() без аргументов, и использует её.

Необязательный параметр result_mode может иметь значение MYSQL_USE_RESULT и MYSQL_STORE_RESULT. По умолчанию MYSQL_STORE_RESULT, т.е. результат буферизуется. См. также mysql_unbuffered_query() - это функция противоположного действия.

Примечание: строка запроса не должна заканчиваться точкой с запятой (;).

Только для операторов SELECT, SHOW, EXPLAIN или DESCRIBE функция mysql_query() возвращает идентификатор ресурса, FALSE если запрос не был выполнен корректно. Для других типов SQL-операторов mysql_query() возвращает TRUE при успехе, FALSE при ошибке. Не-FALSE return-значение означает, что запрос был правильным и может быть выполнен на сервере. Она ничего не сообщает о количестве задействованных или возвращаемых рядов. Это отличная возможность для запроса продолжить выполнениt, не задействуя и не возвращая рядов.

Следующий запрос синтаксически неверен, поэтому mysql_query() терпит неудачу и возвращает FALSE:

mysql_real_escape_string

(только PHP 4 CVS)

mysql_real_escape_string - мнемонизирует специальные символы в строке для использования в операторе SQL с учётом текущего набора символов/charset соединения.

Описание

string mysql_real_escape_string (string unescaped_string [, resource link_identifier])

Эта функция мнемонизирует/escape специальные символы в строке unescaped_string, учитывая текущий charset соединения, чтобы эту строку можно было направить в mysql_query().

Примечание: mysql_real_escape_string() не мнемонизирует % и _.

mysql_result

(PHP 3, PHP 4)

mysql_result - получает результирующие данные.

Описание

mixed mysql_result (resource result, int row [, mixed field])

mysql_result() возвращает содержимое одной ячейки из результирующего набора MySQL. Аргумент field может быть смещением поля, именем поля или именем_таблицы.именем_поля (tablename.fieldname). Если для имени столбца создан псевдоним ('select foo as bar from...'), используйте это псевдоним вместо имени столбца.

При работе с большими результирующими наборами вы можете предусмотреть использование одной из функций, извлекающих ряд целиком (специфицировано далее). Поскольку эти функции возвращают содержимое нескольких ячеек в одном вызове функции, они работают НАМНОГО быстрее, чем mysql_result(). Отметьте также, что специфицирование числового смещения для аргумента field намного быстрее, чем специфицирование аргумента fieldname или tablename.fieldname.

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

Рекомендуемые высокопроизводительные альтернативы: mysql_fetch_row(), mysql_fetch_array() и mysql_fetch_object().

mysql_select_db

(PHP 3, PHP 4)

mysql_select_db - выбирает БД MySQL.

Описание

bool mysql_select_db (string database_name [, resource link_identifier])

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

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

Каждый последующий вызов mysql_query() будет делаться на активной БД.

См. также mysql_connect(), mysql_pconnect() и mysql_query().

Для обеспечения обратной совместимости можно также использовать mysql_selectdb(), но это не рекомендуется.

mysql_stat

(только PHP 4 CVS)

mysql_stat - получает текущий системный статус.

Описание

string mysql_stat ([resource link_identifier])

mysql_stat() возвращает текущий статус сервера.

Примечание: mysql_stat() в настоящее время возвращает только статус запуска/uptime, потоков, запросов, открытых таблиц, очистки таблиц и запросов в секунду. Полный список переменных статуса можно получить sql-командой SHOW STATUS.

mysql_tablename

(PHP 3, PHP 4)

mysql_tablename - получает имя таблицы поля.

Описание

string mysql_tablename (resource result, int i)

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

mysql_thread_id

(только PHP 4 CVS)

mysql_thread_id - возвращает id текущего потока.

Описание

int mysql_thread_id ([resource link_identifier])

mysql_thread_id() возвращает id текущего потока. Если соединение потеряно и вы повторно соединяетесь с помощью mysql_ping(), ID потока изменится. Это значит, что вы не должны получать и сохранять thread ID для последующего использования. Вы должны получать его по мере необходимости.

Пример 1. mysql_thread_id()

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$thread_id = mysql_thread_id($link);
if ($thread_id){
printf ("current thread id is %d\n", $thread_id);
}
?>

Пример даст на выходе:

current thread id is 73

См. также mysql_ping(), mysql_list_processes().

mysql_unbuffered_query

(PHP 4 >= 4.0.6)

mysql_unbuffered_query - отправляет SQL-запрос в MySQL, не извлекая и не буферизуя результирующие ряды.

Описание

resource mysql_unbuffered_query (string query [, resource link_identifier [, int result_mode]])

mysql_unbuffered_query() отправляет SQL-запрос query в MySQL, не извлекая и не буферизуя автоматически результирующие ряды, как это делает mysql_query(). С одной стороны, это сохраняет значительное количество памяти для SQL-запросов, дающих большие результирующие наборы. С другой стороны, вы можете начать работу с результирующим набором срезу после получения первого ряда: вам не нужно ожидать выполнения полного SQL-запроса. При использовании нескольких DB-соединений вы должны специфицировать необязательный параметр link_identifier.

Необязательный параметр result_mode может быть MYSQL_USE_RESULT и MYSQL_STORE_RESULT. По умолчанию MYSQL_USE_RESULT, поэтому результат не буферизуется. См. также mysql_query() - обратную функцию.

Примечание: преимущества mysql_unbuffered_query() требуют компенсации: вы не можете использовать mysql_num_rows() с результирующим набором, возвращаемым из mysql_unbuffered_query(). Вы также должны извлекать все результаты из небуферизованного SQL-запроса, прежде чем сможете отправить новый SQL-запрос в MySQL.

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

natcasesort

(PHP 4)

natcasesort - сортирует массив с использованием нечувствительного к регистру символов алгоритма "natural order/натуральный порядок".

Описание

void natcasesort (array array)

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

natcasesort() это нечувствительная к регистру версия natsort(). См. в natsort() пример разницы между этим алгоритмом и обычными алгоритмами компьютерной сортировки строк.

Дополнительно см. странице Martin'а Pool'а Natural Order String Comparison.

См. также sort(), natsort(), strnatcmp() и strnatcasecmp().

natsort

(PHP 4)

natsort - сортирует массив с использованием алгоритма "natural order".

Описание

void natsort (array array)

Эта функция реализует алгоритм сортировки, упорядочивая алфавитно-числовые строки по-человечески. Это описано как "natural ordering/натуральный порядок". Вот пример отличия этого алгоритма от алгоритмов обычной компьютерной сортировки (используемой в sort()):

Пример 1. natsort()

$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png");
sort($array1);
echo "Standard sorting\n";
print_r($array1);
natsort($array2);
echo "\nNatural order sorting\n";
print_r($array2);

Этот код сгенерирует следующий вывод:

ncurses_addch

(PHP 4 >= 4.1.0)

ncurses_addch - добавляет символ в текущей позиции и передвигает курсор.

Описание

int ncurses_addch (int ch)

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

ncurses_addchnstr

(PHP 4 >= 4.2.0)

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

Описание

int ncurses_addchnstr (string s, int n)

ncurses_addchstr

(PHP 4 >= 4.2.0)

ncurses_addchstr - добавляет строку с атрибутами в текущей позиции.

Описание

int ncurses_addchstr (string s)

ncurses_addnstr

(PHP 4 >= 4.2.0)

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

Описание

int ncurses_addnstr (string s, int n)

ncurses_addstr

(PHP 4 >= 4.2.0)

ncurses_addstr - выводит текст в текущей позиции.

Описание

int ncurses_addstr (string text)

ncurses_assume_default_colors

(PHP 4 >= 4.2.0)

ncurses_assume_default_colors - определяет цвета по умолчанию для цвета 0.

Описание

int ncurses_assume_default_colors (int fg, int bg)

ncurses_attroff

(PHP 4 >= 4.1.0)

ncurses_attroff - отключает данные атрибуты.

Описание

int ncurses_attroff (int attributes)

ncurses_attron

(PHP 4 >= 4.1.0)

ncurses_attron - отключает данные атрибуты.

Описание

int ncurses_attron (int attributes)

ncurses_attrset

(PHP 4 >= 4.1.0)

ncurses_attrset - устанавливает данные атрибуты.

Описание

int ncurses_attrset (int attributes)

ncurses_baudrate

(PHP 4 >= 4.1.0)

ncurses_baudrate - возвращает baudrate (бод-диапазон) терминала.

Описание

int ncurses_baudrate (void)

ncurses_beep

(PHP 4 >= 4.1.0)

ncurses_beep - "бип" терминала.

Описание

int ncurses_beep (void)

ncurses_beep() производит аудиосигнал (bell) и, если невозможно, очищает экран. Возвращает FALSE при успехе, иначе TRUE.

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

ncurses_bkgd

(PHP 4 >= 4.1.0)

ncurses_bkgd - устанавливает свойство background экрана терминала.

Описание

int ncurses_bkgd (int attrchar)

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

ncurses_bkgdset

(PHP 4 >= 4.1.0)

ncurses_bkgdset - управляет фоном экрана.

Описание

void ncurses_bkgdset (int attrchar)

ncurses_border

(PHP 4 >= 4.2.0)

ncurses_border - рисует рамку экрана с использованием атрибуированных символов.

Описание

int ncurses_border (int left, int right, int top, int bottom, int tl_corner, int tr_corner, int bl_corner, int br_corner)

ncurses_can_change_color

(PHP 4 >= 4.1.0)

ncurses_can_change_color - проверяет, можем ли мы изменять цвета терминала.

Описание

bool ncurses_can_change_color (void)

Функция ncurses_can_change_color() возвращает TRUE или FALSE, в зависимости от того, имеет ли терминал цветовые возможности и может ли программист изменять цвета.

ncurses_cbreak

(PHP 4 >= 4.1.0)

ncurses_cbreak - выключает буферизацию ввода.

Описание

bool ncurses_cbreak (void)

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

ncurses_cbreak() возвращает TRUE, или NCURSES_ERR, если возникла ошибка.

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

ncurses_clear

(PHP 4 >= 4.1.0)

ncurses_clear - очищает экран.

Описание

bool ncurses_clear (void)

ncurses_clear() полностью очищает экран без установки пробелов. Возвращает FALSE при успехе, иначе TRUE.

Примечание: ncurses_clear() очищает экран без установки пустот/blanks, имеющий текущую передачу фона. Для очистки экрана с пустотами используйте ncurses_erase().

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

ncurses_clrtobot

(PHP 4 >= 4.1.0)

ncurses_clrtobot - очищает экран от текущей позиции донизу.

Описание

bool ncurses_clrtobot (void)

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

ncurses_clrtobot() удаляет все строчки от курсора до конца экрана и создаёт пустоты/blanks. Пустоты, созданные функцией ncurses_clrtobot(), имеют текущую передачу фона. Возвращает TRUE, если возникла ошибка, иначе FALSE.

См. также ncurses_clear(), ncurses_clrtoeol().

ncurses_clrtoeol

(PHP 4 >= 4.1.0)

ncurses_clrtoeol - очищает экран от текущей позиции до конца строчки.

Описание

bool ncurses_clrtoeol (void)

ncurses_clrtoeol() очищает текущую строчку от позиции курсора до конца. Пустоты/Blanks, созданные ncurses_clrtoeol(), имеют текущее представление фона. Возвращает TRUE, если возникла ошибка, иначе FALSE.

См. также ncurses_clear(), ncurses_clrtobot().

ncurses_color_set

(PHP 4 >= 4.1.0)

ncurses_color_set - устанавливает цвет переднего плана и фона.

Описание

int ncurses_color_set (int pair)

ncurses_curs_set

(PHP 4 >= 4.1.0)

ncurses_curs_set - устанавливает состояние курсора.

Описание

int ncurses_curs_set (int visibility)

ncurses_def_prog_mode

(PHP 4 >= 4.1.0)

ncurses_def_prog_mode - сохраняет режим (программный) терминала.

Описание

bool ncurses_def_prog_mode (void)

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

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

ncurses_def_shell_mode

(PHP 4 >= 4.1.0)

ncurses_def_shell_mode - сохраняет режим терминала (оболочки).

Описание

bool ncurses_def_shell_mode (void)

ncurses_def_shell_mode() сохраняет текущие режимы терминала оболочки (не в curses) для использования функцией ncurses_reset_shell_mode(). Возвращает FALSE при успехе, иначе TRUE.

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

ncurses_define_key

(PHP 4 >= 4.2.0)

ncurses_define_key - определяет код клавиши.

Описание

int ncurses_define_key (string definition, int keycode)

ncurses_delay_output

(PHP 4 >= 4.1.0)

ncurses_delay_output - задерживает вывод на терминал с использованием заполняющих символов.

Описание

int ncurses_delay_output (int milliseconds)

ncurses_delch

(PHP 4 >= 4.1.0)

ncurses_delch - удаляет символ в текущей позиции, сдвигая остаток строки влево.

Описание

bool ncurses_delch (void)

ncurses_delch() удаляет символ в позиции курсора. Все символы справа от курсора в той же строке сдвигаются влево на одну позицию, а последний символ строки заполняется пустышкой/blank. Позиция курсора не изменяется. Возвращает FALSE при успехе, иначе TRUE.

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

ncurses_deleteln

(PHP 4 >= 4.1.0)

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

Описание

bool ncurses_deleteln (void)

ncurses_deleteln() удаляет строчку в текущей позиции курсора. Все строки ниже текущей сдвигаются вверх на одну строчку. Нижняя строка окна очищается. Позиция курсора не изменяется. Возвращает FALSE при успехе, иначе TRUE.

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

ncurses_delwin

(PHP 4 >= 4.1.0)

ncurses_delwin - удаляет окно ncurses.

Описание

int ncurses_delwin (resource window)

ncurses_doupdate

(PHP 4 >= 4.1.0)

ncurses_doupdate - записывает все подготовленные обновления в терминал.

Описание

bool ncurses_doupdate (void)

ncurses_doupdate()() сравнивает виртуальный экран с физическим и обновляет физический экран. Это более эффективно, чем использование нескольких вызовов refresh. Возвращает FALSE при успехе, TRUE, если возникла ошибка.

ncurses_echo

(PHP 4 >= 4.1.0)

ncurses_echo - активирует отображение клавиатурного ввода.

Описание

bool ncurses_echo (void)

ncurses_echo() включает режим echo. Все символы, вводимые пользователем, печатаются функцией ncurses_getch(). Возвращает FALSE при успехе, TRUE, если возникла ошибка.

Для отключения режима echo используйте ncurses_noecho().

ncurses_echochar

(PHP 4 >= 4.1.0)

ncurses_echochar - выводит одиночный символ, включая refresh.

Описание

int ncurses_echochar (int character)

ncurses_end

(PHP 4 >= 4.1.0)

ncurses_end - останавливает использование ncurses, очищает экран.

Описание

int ncurses_end (void)

ncurses_erase

(PHP 4 >= 4.1.0)

ncurses_erase - стирает экран терминала.

Описание

bool ncurses_erase (void)

ncurses_erase() заполняет экран терминала заглушками/blanks. Созданные заглушки имеют отображение текущего фона, установленное функцией ncurses_bkgd(). Возвращает FALSE при успехе, TRUE, если возникла ошибка.

См. также ncurses_bkgd(), ncurses_clear().

ncurses_erasechar

(PHP 4 >= 4.1.0)

ncurses_erasechar - возвращает текущий стёртый символ.

Описание

string ncurses_erasechar (void)

ncurses_erasechar() возвращает текущий стёртый char-символ.

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

ncurses_filter

(PHP 4 >= 4.1.0)

ncurses_filter - >

Описание

int ncurses_filter (void)

ncurses_flash

(PHP 4 >= 4.1.0)

ncurses_flash - очищает экран терминала (визуальный bell).

Описание

bool ncurses_flash (void)

ncurses_flash() очищает экран и, если это невозможно, отправляет звуковой сигнал (bell). Возвращает FALSE при успехе, иначе TRUE.

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

ncurses_flushinp

(PHP 4 >= 4.1.0)

ncurses_flushinp - очищает буфер клавиатурного ввода.

Описание

bool ncurses_flushinp (void)

ncurses_flushinp() отбрасывает всё, что напечатано и ещё не прочитано вашей программой. Возвращает FALSE при успехе, иначе TRUE.

ncurses_getch

(PHP 4 >= 4.1.0)

ncurses_getch - читает символ с клавиатуры.

Описание

int ncurses_getch (void)

ncurses_getmouse

(PHP 4 >= 4.2.0)

ncurses_getmouse - читает событие мыши.

Описание

bool ncurses_getmouse (array mevent)

ncurses_getmouse() читает событие мыши из очереди. Функция ncurses_getmouse() возвратит FALSE, если событие мыши видно в данном окне, иначе TRUE. Опции события задаются в параметре mevent, который является массивом, передаваемым по ссылке (см. пример ниже). При успехе предоставляется ассоциативный массив со следующими ключами:

"id" : Id для отличения нескольких устройств

"x" : x-позиция на экране в ячейках символов

"y" : y-позиция на экране в ячейках символов

"z" : в настоящее время не поддерживается

"mmask" : акция мыши

ncurses_halfdelay

(PHP 4 >= 4.1.0)

ncurses_halfdelay - переводит терминал в режим halfdelay.

Описание

int ncurses_halfdelay (int tenth)

ncurses_has_colors

(PHP 4 >= 4.1.0)

ncurses_has_colors - проверяет, имеет ли терминал цвета.

Описание

bool ncurses_has_colors (void)

ncurses_has_colors() возвращает TRUE или FALSE, в зависимости от того, имеет ли терминал цветовые возможности.

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

ncurses_has_ic

(PHP 4 >= 4.1.0)

ncurses_has_ic - проверяет на наличие возможностей insert и delete.

Описание

bool ncurses_has_ic (void)

ncurses_has_ic() проверяет возможности insert и delete терминала. Возвращает TRUE, если терминал имеет insert/delete-возможности, иначе FALSE.

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

ncurses_has_il

(PHP 4 >= 4.1.0)

ncurses_has_il - проверяет возможности insert/delete строчек.

Описание

bool ncurses_has_il (void)

ncurses_has_il() проверяет наличие у терминала возможностей insert/delete строчек. Возвращает TRUE, если терминал имеет insert/delete-возможности строчек, иначе FALSE.

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

ncurses_has_key

(PHP 4 >= 4.1.0)

ncurses_has_key - проверяет наличие функциональной клавиши на клавиатуре терминала.

Описание

int ncurses_has_key (int keycode)

ncurses_hline

(PHP 4 >= 4.2.0)

ncurses_hline - рисует горизонтальную линию в текущей позиции, используя атрибуированный символ и max. n символов длины.

Описание

int ncurses_hline (int charattr, int n)

ncurses_inch

(PHP 4 >= 4.1.0)

ncurses_inch - получает символ и атрибут в текущей позиции.

Описание

string ncurses_inch (void)

ncurses_inch() возвращает символ в текущей позиции.

ncurses_init

(PHP 4 >= 4.1.0)

ncurses_init - инициализирует ncurses.

Описание

int ncurses_init (void)

ncurses_init_color

(PHP 4 >= 4.2.0)

ncurses_init_color - устанавливает новое RGB-значение цвета.

Описание

int ncurses_init_color (int color, int r, int g, int b)

ncurses_init_pair

(PHP 4 >= 4.1.0)

ncurses_init_pair - выделяет цветовую пару.

Описание

int ncurses_init_pair (int pair, int fg, int bg)

ncurses_insch

(PHP 4 >= 4.1.0)

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

Описание

int ncurses_insch (int character)

ncurses_insdelln

(PHP 4 >= 4.1.0)

ncurses_insdelln - вставляет строчки перед прокруткой текущей строчки (отрицательные значения удаляют и прокручивают вверх).

Описание

int ncurses_insdelln(int count)

ncurses_insertln

(PHP 4 >= 4.1.0)

ncurses_insertln - вставляет строчку, сдвигая остаток экрана вниз.

Описание

bool ncurses_insertln (void)

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

ncurses_insertln() вставляет новую строчку над текущей. Нижняя строчка теряется.

ncurses_insstr

(PHP 4 >= 4.2.0)

ncurses_insstr - вставляет строку в текущей позиции, сдвигая остаток строчки вправо.

Описание

int ncurses_insstr (string text)

ncurses_instr

(PHP 4 >= 4.2.0)

ncurses_instr - читает строку с экрана терминала.

Описание

int ncurses_instr (string buffer)

ncurses_instr() возвращает количество символов, прочитанных от текущей позиции до конца строчки. buffer содержит эти символы. Атрибуты вырезаются из этих символов.

ncurses_isendwin

(PHP 4 >= 4.1.0)

ncurses_isendwin - Ncurses находится в режиме endwin, может выполняться нормальный вывод на экран.

Описание

bool ncurses_isendwin (void)

ncurses_isendwin() возвращает TRUE, если ncurses_endwin() был вызван без последующих вызовов ncurses_wrefresh(), иначе FALSE.

См. также ncurses_endwin(), ncurses_wrefresh().

ncurses_keyok

(PHP 4 >= 4.2.0)

ncurses_keyok - включает или отключает keycode.

Описание

int ncurses_keyok (int keycode, bool enable)

ncurses_killchar

(PHP 4 >= 4.1.0)

ncurses_killchar - возвращает замоченный символ текущей строчки.

Описание

bool ncurses_killchar (void)

ncurses_killchar() возвращает замоченный символ текущей строчки.

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

ncurses_longname

(PHP 4 >= 4.2.0)

ncurses_longname - возвращает описание терминала.

Описание

string ncurses_longname (void)

ncurses_longname() возвращает словесное описание терминала. Описание усекается до 128 символов. При ошибке функция ncurses_longname() возвращает NULL.

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

ncurses_mouseinterval

(PHP 4 >= 4.1.0)

ncurses_mouseinterval - устанавливает таймаут для щелчков мыши.

Описание

int ncurses_mouseinterval (int milliseconds)

ncurses_mousemask

(PHP 4 >= 4.2.0)

ncurses_mousemask - устанавливает опции мыши.

Описание

int ncurses_mousemask (int newmask, int oldmask)

Функция ncurses_mousemask() установит события мыши, о которых сообщается. По умолчанию о событиях мыши не сообщается. Функция ncurses_mousemask() возвращает маску, указывающую, о каких из событий в параметре newmask можно сообщать. При полном обломе возвращает 0. В параметре oldmask, который передаётся по ссылке, ncurses_mousemask() возвращает предыдущее значение маски событий мыши. События мыши представлены NCURSES_KEY_MOUSE в потоке ввода ncurses_wgetch(). Для чтения событий мыши и выталкивания событий из очереди вызывайте ncurses_getmouse().

Как побочный эффект, установка 0 маски мыши в newmask отключает указатель мыши. Установка ненулевого значения включает указатель мыши.

Опции маски мыши можно устанавливать со следующими предопределёнными константами:

NCURSES_BUTTON1_PRESSED

NCURSES_BUTTON1_RELEASED

NCURSES_BUTTON1_CLICKED

NCURSES_BUTTON1_DOUBLE_CLICKED

NCURSES_BUTTON1_TRIPLE_CLICKED

NCURSES_BUTTON2_PRESSED

NCURSES_BUTTON2_RELEASED

NCURSES_BUTTON2_CLICKED

NCURSES_BUTTON2_DOUBLE_CLICKED

NCURSES_BUTTON2_TRIPLE_CLICKED

NCURSES_BUTTON3_PRESSED

NCURSES_BUTTON3_RELEASED

NCURSES_BUTTON3_CLICKED

NCURSES_BUTTON3_DOUBLE_CLICKED

NCURSES_BUTTON3_TRIPLE_CLICKED

NCURSES_BUTTON4_PRESSED

NCURSES_BUTTON4_RELEASED

NCURSES_BUTTON4_CLICKED

NCURSES_BUTTON4_DOUBLE_CLICKED

NCURSES_BUTTON4_TRIPLE_CLICKED

NCURSES_BUTTON_SHIFT

NCURSES_BUTTON_CTRL

NCURSES_BUTTON_ALT

NCURSES_ALL_MOUSE_EVENTS

NCURSES_REPORT_MOUSE_POSITION

См. также ncurses_getmouse(), ncurses_ungetmouse() ncurese_getch().

ncurses_move

(PHP 4 >= 4.1.0)

ncurses_move - перемещает позицию вывода.

Описание

int ncurses_move (int y, int x)

ncurses_mvaddch

(PHP 4 >= 4.2.0)

ncurses_mvaddch - перемещает текущую позицию и добавляет символ.

Описание

int ncurses_mvaddch (int y, int x, int c)

ncurses_mvaddchnstr

(PHP 4 >= 4.2.0)

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

Описание

int ncurses_mvaddchnstr (int y, int x, string s, int n)

ncurses_mvaddchstr

(PHP 4 >= 4.2.0)

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

Описание

int ncurses_mvaddchstr (int y, int x, string s)

ncurses_mvaddnstr

(PHP 4 >= 4.2.0)

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

Описание

int ncurses_mvaddnstr (int y, int x, string s, int n)

ncurses_mvaddstr

(PHP 4 >= 4.2.0)

ncurses_mvaddstr - перемещает позицию и добавляет строку.

Описание

int ncurses_mvaddstr (int y, int x, string s)

ncurses_mvcur

(PHP 4 >= 4.2.0)

ncurses_mvcur - перемещает курсор немедленно.

Описание

int ncurses_mvcur (int old_y, int old_x, int new_y, int new_x)

ncurses_mvdelch

(PHP 4 >= 4.2.0)

ncurses_mvdelch - перемещает позицию и удаляет символ, сдвигая остаток строчки влево.

Описание

int ncurses_mvdelch (int y, int x)

ncurses_mvgetch

(PHP 4 >= 4.2.0)

ncurses_mvgetch - перемещает позицию и получает символ в новой позиции.

Описание

int ncurses_mvgetch (int y, int x)

ncurses_mvhline

(PHP 4 >= 4.2.0)

ncurses_mvhline - устанавливает новую позицию и рисует горизонтальную линию с использованием атрибуированного символа и максимум n символов длины.

Описание

int ncurses_mvhline ( int y, int x, int attrchar, int n)

ncurses_mvinch

(PHP 4 >= 4.2.0)

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

Описание

int ncurses_mvinch (int y, int x)

ncurses_mvvline

(unknown)

ncurses_mvvline - устанавливает новую позицию и рисует вертикальную линию с использованием атрибуированного символа и максимум n символов длины.

Описание

int ncurses_mvvline (int y, int x, int attrchar, int n)

ncurses_mvwaddstr

(PHP 4 >= 4.2.0)

ncurses_mvwaddstr - добавляет строку в новой позиции в окне.

Описание

int ncurses_mvwaddstr (resource window, int y, int x, string text)