ftp_set_option

(PHP 4 >= 4.2.0)

ftp_set_option - устанавливает различные FTP-опции времени выполнения.

Описание

bool ftp_set_option (resource ftp_stream, int option, mixed value)

Примечание: эта функция доступна только в CVS.

Возвращает TRUE, если опция может быть установлена; FALSE - если нет. Будет выдано предупреждение, если option не поддерживается или если переданное значение value не соответствует ожидаемому для данной option значению.

Эта функция управляет различными опциями времени выполнения для специфицированного FTP-потока. Параметр value зависит от того, какой параметр option выбран для изменения. В настоящее время поддерживаются следующие опции:

Таблица 1. Поддерживаемые FTP-опции времени выполнения

FTP_TIMEOUT_SECИзменяет таймаут в секундах для всех сетевых функций. Параметр value должен быть типа int и обязан быть больше 0. По умолчанию таймаут равен 90 секундам.

ftp_site

(PHP 3>= 3.0.15, PHP 4)

ftp_site - отправляет команду SITE на сервер.

Описание

bool ftp_site (resource ftp_stream, string cmd)

ftp_site() отправляет команду, специфицированную параметром cmd, на FTP-сервер. SITE-команды не стандартизованы и различаются на разных серверах. Они используются для работы допуском к файлам и членством в группах.

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

ftp_size

(PHP 3>= 3.0.13, PHP 4)

ftp_size - возвращает размер данного файла.

Описание

int ftp_size (resource ftp_stream, string remote_file)

ftp_size() возвращает размер файла в байтах. Если возникает ошибка или файл не существует, возвращается -1. Не все серверы поддерживают эту возможность.

Возвращает размер файла при успехе или -1 при неудаче.

ftp_systype

(PHP 3>= 3.0.13, PHP 4)

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

Описание

string ftp_systype (resource ftp_stream)

Возвращает тип удалённой системы или FALSE при ошибке.

ftruncate

(PHP 4)

ftruncate - усекает файл до данного размера.

Описание

int ftruncate (int fp, int size)

Принимает указатель файла fp и усекает файл до размера size. Эта функция возвращает TRUE при успехе, FALSE при неудаче.

func_get_arg

(PHP 4)

func_get_arg - возвращает элемент из списка аргументов.

Описание

mixed func_get_arg (int arg_num)

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

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

func_get_args

(PHP 4)

func_get_args - возвращает массив - список аргументов функции.

Описание

array func_get_args (void)

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

func_num_args

(PHP 4)

func_num_args - возвращает количество аргументов, переданных функции.

Описание

int func_num_args (void)

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

IV. Функции. Справочник.

Содержание
I. Функции, специфичные для Apache
II. Массивы
III. Aspell [не рекомендуются]
IV. BCMath математические функции произвольной точности
V. Bzip2-компрессия
VI. Календарные
VII. CCVS API
VIII. Поддержка COM для Windows
IX. Класс/Объект
X. ClibPDF
XI. Crack
XII. CURL, Client URL Library
XIII. Cybercash-платежи
XIV. Crédit Mutuel CyberMUT
XV. Cyrus IMAP администрирование
XVI. Функции типов символов
XVII. Database (dbm-стиль) абстрактные слои
XVIII. Дата и время
XIX. dBase
XX. DBM
XXI. dbx
XXII. DB++
XXIII. Direct IO
XXIV. Директории
XXV. DOM XML
XXVI. .NET
XXVII. Обработка ошибок и логинг
XXVIII. FrontBase
XXIX. filePro
XXX. Файловая система
XXXI. Forms Data Format
XXXII. FriBiDi
XXXIII. FTP
XXXIV. Работа с функциями
XXXV. Gettext
XXXVI. GMP
XXXVII. HTTP
XXXVIII. Hyperwave
XXXIX. Hyperwave API
XL. ICAP [не рекомендуются]
XLI. iconv
XLII. Image
XLIII. IMAP, POP3 и NNTP
XLIV. Informix
XLV. InterBase
XLVI. Ingres II
XLVII. IRC Gateway
XLVIII. Java
XLIX. LDAP
L. Mail
LI. mailparse
LII. Математические
LIII. Многобайтные строки
LIV. MCAL
LV. Mcrypt-кодировка
LVI. Mhash
LVII. Mimetype
LVIII. Microsoft SQL Server
LIX. Ming-функции для Flash
LX. Прочие функции
LXI. mnoGoSearch
LXII. mSQL
LXIII. MySQL
LXIV. Mohawk Software обработчик сессии
LXV. muscat
LXVI. Сетевые функции
LXVII. Управление экраном терминала Ncurses
LXVIII. Lotus Notes
LXIX. Унифицированный ODBC
LXX. Oracle 8
LXXI. OpenSSL
LXXII. Oracle
LXXIII. Ovrimos SQL
LXXIV. Управление выводом
LXXV. Перегрузка свойства объекта и вызова метода
LXXVI. PDF
LXXVII. Verisign Payflow Pro
LXXVIII. PHP Опции & Информация
LXXIX. POSIX
LXXX. PostgreSQL
LXXXI. Управление процессом
LXXXII. Выполнение программы
LXXXIII. Принтер
LXXXIV. Pspell
LXXXV. GNU Readline
LXXXVI. GNU Recode
LXXXVII. Регулярные выражения (Perl-совместимые)
LXXXVIII. qtdom
LXXXIX. Регулярные выражения (POSIX Extended)
XC. Semaphore, Shared Memory и IPC
XCI. SESAM БД
XCII. Обслуживание сессий
XCIII. Совместно используемая память
XCIV. Shockwave Flash
XCV. SNMP
XCVI. Сокеты
XCVII. Строковые функции
XCVIII. Sybase
XCIX. URL
C. Работа с переменными
CI. vpopmail
CII. W32api
CIII. WDDX
CIV. XML-разборщик
CV. XMLRPC
CVI. XSLT
CVII. YAZ
CVIII. YP/NIS
CIX. Zip-файл (доступ только для чтения)
CX. Zlib-компрессия

function_exists

(PHP 3>= 3.0.7, PHP 4)

function_exists - возвращает TRUE, если данная функция определена.

Описание

bool function_exists (string function_name)

Проверяет в списке определённых функций, встроенных (внутренних) и пользовательских, наличие функции function_name. Возвращает TRUE при успехе, FALSE - при ошибке.

fwrite

(PHP 3, PHP 4)

fwrite - Binary-safe запись файла.

Описание

int fwrite (int fp, string string [, int length])

fwrite() записывает содержимое строки string в поток файла, специфицированного указателем fp. Если аргумент length задан, запись будет остановлена после записи length количества байтов или достижения конца string, смотря что будет выполнено вперёд.

fwrite() возвращает количество записанных байт, или -1 при ошибке.

Заметьте, что, если аргумент length задан, опция конфигурации magic_quotes_runtime будет проигнорирована и слэши не будут вырезаны из string.

Примечание: в системах, различающих бинарные и текстовые файлы (Windows), файл обязан быть открыт с буквой 'b' в качестве параметра режима функции fopen().

См. также fread(), fopen(), fsockopen(), popen() и fputs().

get_browser

(PHP 3, PHP 4)

get_browser - сообщает о возможностях браузера.

Описание

object get_browser ([string user_agent])

get_browser() пытается определить возможности браузера пользователя. Это делается путём просмотра информации в файле browscap.ini file. По умолчанию используется значение переменной $HTTP_USER_AGENT; однако вы можете изменить это (т.е. просмотреть другую информацию о браузере), передав необязательный параметр user_agent функции get_browser().

Информация возвращается как объект, содержащий различные элементы данных, представляющие, например, номер наибольшей и наименьшей версии браузера и строку ID; значения TRUE/FALSE для таких возможностей, как отображение фрэймов, JavaScript, куки; и так далее.

Поскольку browscap.ini содержит информацию о многих браузерах, он основан на пользовательских обновлениях данных. Формат этого файла достаточно понятен сам по себе.

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

get_cfg_var

(PHP 3, PHP 4)

get_cfg_var - получает значение опции конфигурации PHP.

Описание

string get_cfg_var (string varname)

Возвращает текущее значение переменной конфигурации PHP, специфицированной в varname, или FALSE, если возникла ошибка.

Она не возвращает информацию конфигурации, установленную при компиляции PHP, и не читает из файла конфигурации Apache (используя директивы php3_configuration_option).

Чтобы проверить, использует ли система файл конфигурации, попытайтесь запросить значение установки конфигурации cfg_file_path. Если она доступна, файл конфигурации используется.

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

get_class

(PHP 4)

get_class - возвращает имя класса объекта.

Описание

string get_class (object obj)

Эта функция возвращает имя класса, экземпляром которого является объект obj. Возвращает FALSE, если obj не является объектом.

Примечание: get_class() возвращает имя пользовательского класса в нижнем регистре. Класс, определённый в PHP-расширении, возвращается в оригинальной нотации.

См. также get_parent_class(), gettype() и is_subclass_of().

get_class_methods

(PHP 4)

get_class_methods - возвращает массив имён методов класса.

Описание

array get_class_methods (mixed class_name)

Эта функция возвращает имена методов, определённых для класса, специфицированного параметром class_name.

Примечание: начиная с PHP 4.0.6, вы можете специфицировать сам объект вместо class_name. Например:

get_class_vars

(PHP 4)

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

Описание

array get_class_vars (string class_name)

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

Примечание: неинициализированные переменные класса не выводятся функцией get_class_vars().

get_current_user

(PHP 3, PHP 4)

get_current_user - получает имя владельца текущего PHP-скрипта.

Описание

string get_current_user (void)

Возвращает имя имя владельца текущего PHP-скрипта.

См. также getmyuid(), getmygid(), getmypid(), getmyinode() и getlastmod().

get_declared_classes

(PHP 4)

get_declared_classes - возвращает массив с именем определённого класса.

Описание

array get_declared_classes (void)

Эта функция возвращает массив имён объявленных классов в текущем скрипте.

Примечание: в PHP 4.0.1pl2 дополнительно три класса возвращаются в начале массива: stdClass (определённый в Zend/zend.c), OverloadedTestClass (определённый в ext/standard/basic_functions.c) и Directory (определённый в ext/standard/dir.c).

Отметьте также, что, в зависимости от того, какие библиотеки вы скомпилировали с PHP, могут появиться и другие классы. Это значит, что вы не сможете определить ваши собственные классы с теми же именами. В разделе Предопределённый классы имеется список классов.

get_defined_constants

(PHP 4 >= 4.1.0)

get_defined_constants - возвращает ассоциативный массив из имён всех констант и их значений.

Описание

array get_defined_constants (void)

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

Например эта строка:

get_defined_functions

(PHP 4 >= 4.0.4)

get_defined_functions - возвращает массив из всех определённых функций.

Описание

array get_defined_functions (void)

Эта функция возвращает многомерный массив, содержащий список всех определённых функций, встроенных (внутренних) и пользовательских. Внутренние функции будут доступны через $arr["internal"], а пользовательские - через $arr["user"] (см. пример ниже).

get_defined_vars

(PHP 4 >= 4.0.4)

get_defined_vars - возвращает массив из всех определённых переменных.

Описание

array get_defined_vars (void)

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

get_extension_funcs

(PHP 4)

get_extension_funcs - возвращает массив из имён функций модуля.

Описание

array get_extension_funcs (string module_name)

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

Например, эти строки:

get_html_translation_table

(PHP 4)

get_html_translation_table - возвращает таблицу трансляции, используемую функциями htmlspecialchars() и htmlentities().

Описание

string get_html_translation_table (int table [, int quote_style])

get_html_translation_table() возвратит таблицу трансляции, используемую внутренне для функций htmlspecialchars() и htmlentities(). Имеются два новых определения (HTML_ENTITIES, HTML_SPECIALCHARS), позволяющие специфицировать необходимую таблицу. И, как и в функциях htmlspecialchars() и htmlentities(), вы можете по выбору специфицировать quote_style, с которым вы работаете. По умолчанию установлен режим ENT_COMPAT. См. описание режимов в htmlspecialchars().

get_included_files

(PHP 4)

get_included_files - возвращает массив из имён файлов, включаемых (include) или необходимых.

Описание

array get_included_files (void)

Возвращает массив имён всех файлов, которые включены с использованием include(), include_once(), require() или require_once().

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

Примечание: файлы, включённые с использованием директивы конфигурации auto_prepend_file, не входят в возвращаемый массив.

get_loaded_extensions

(PHP 4)

get_loaded_extensions - возвращает массив из имён всех загруженных и скомпилированных модулей.

Описание

array get_loaded_extensions (void)

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

Например, эта строка:

print_r (get_loaded_extensions());

выведет примерно:

get_magic_quotes_gpc

(PHP 3>= 3.0.6, PHP 4)

get_magic_quotes_gpc - получает текущую активную установку конфигурации "магических" кавычек gpc.

Описание

long get_magic_quotes_gpc (void)

Возвращает текущую активную установку конфигурации magic_quotes_gpc (0 для off, 1 для on).

См. также get_magic_quotes_runtime() и set_magic_quotes_runtime().

get_magic_quotes_runtime

(PHP 3>= 3.0.6, PHP 4)

get_magic_quotes_runtime - получает текущую активную установку конфигурации magic_quotes_runtime.

Описание

long get_magic_quotes_runtime (void)

Возвращает текущую активную установку конфигурации magic_quotes_runtime (0 для off, 1 для on).

См. также get_magic_quotes_gpc() и set_magic_quotes_runtime().

get_meta_tags

(PHP 3>= 3.0.4, PHP 4)

get_meta_tags - извлекает все content-атрибуты тэгов meta файла и возвращает массив.

Описание

array get_meta_tags (string filename [, int use_include_path])

Открывает файл filename и разбирает построчно тэги <meta> формы.

get_object_vars

(PHP 4)

get_object_vars - возвращает ассоциативный массив из свойств объекта.

Описание

array get_object_vars (object obj)

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

Пример 1. Использование get_object_vars()

get_parent_class

(PHP 4)

get_parent_class - запрашивает имя родительского класса для объекта или класса.

Описание

string get_parent_class (mixed obj)

Если obj это объект, возвращает имя родительского класса для класса, экземпляром которого является obj.

Если obj это строка, возвращает имя родительского класса для класса с этим именем. Эта функциональность была введена в PHP 4.0.5.

См. также get_class() и is_subclass_of().

get_required_files

(PHP 4)

get_required_files - возвращает массив из имён включённых/included или требуемых/required файлов.

Описание

array get_required_files (void)

Как и в PHP 4.0.4, эта функция является псевдонимом для get_included_files().

В PHP 4.0.1pl2 и предыдущих версиях get_required_files() принимает, что требуемые/required файлы имеют расширение .php, другие расширения не возвращаются. Массив, возвращаемый функцией get_required_files(), был ассоциативным массивом и перечислял только файлы включённые/included функциями require() и require_once().

См. также require(), require_once(), include(), include_once() и get_included_files().

get_resource_type

(PHP 4 >= 4.0.2)

get_resource_type - возвращает тип ресурса.

Описание

string get_resource_type (resource handle)

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

getallheaders

(PHP 3, PHP 4)

getallheaders - извлекает все HTTP-шапки/headers запроса.

Описание

array getallheaders (void)

Эта функция возвращает ассоциативный массив всех HTTP headers в текущем запросе.

Примечание: вы можете также получить из окружения значения обычных переменных CGI, которые работают независимо от того, используете вы PHP как Apache-модуль или нет. Используйте функцию phpinfo() для получения списка всех переменных окружения, определённых этим способом.

getcwd

(PHP 4)

getcwd - получает текущую рабочую директорию.

Описание

string getcwd (void)

Возвращает текущую рабочую директорию.

getdate

(PHP 3, PHP 4)

getdate - получает информацию даты/времени.

Описание

array getdate ([int timestamp])

Возвращает ассоциативный массив, содержащий информацию даты из timestamp или текущего локального времени, если timestamp не задан, со следующими элементами массива:

"seconds" - секунды

"minutes" - минуты

"hours" - часы

"mday" - день (число) месяца

"wday" - день недели цифрой: от 0 - Sunday до 6 - Saturday

"mon" - месяц (цифрой)

"year" - год (цифрой)

"yday" - день года (цифрой); например, "299"

"weekday" - день недели (текст) полный; например, "Friday"

"month" - месяц (текст) полный; например, "January"

getenv

(PHP 3, PHP 4)

getenv - получает значение переменной окружения.

Описание

string getenv (string varname)

Возвращает значение переменной окружения varname или FALSE - при ошибке.

gethostbyaddr

(PHP 3, PHP 4)

gethostbyaddr - получает имя Internet-хоста, соответствующее данному IP-адресу.

Описание

string gethostbyaddr (string ip_address)

Возвращает имя Internet-хоста, специфицированного параметром ip_address. Если возникает ошибка, возвращает ip_address.

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

gethostbyname

(PHP 3, PHP 4)

gethostbyname - получает IP-адрес, соответствующий имени данного Internet-хоста.

Описание

string gethostbyname (string hostname)

Возвращает IP-адрес Internet-хоста, специфицированного параметром hostname.

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

gethostbynamel

(PHP 3, PHP 4 )

gethostbynamel - получает список IP-адресов, соответствующих имени данного Internet-хоста.

Описание

array gethostbynamel (string hostname)

Возвращает список IP-адресов. в которые разрешается Internet-хост, специфицированный параметром hostname.

См. также gethostbyname(), gethostbyaddr(), checkdnsrr(), getmxrr().

getimagesize

(PHP 3, PHP 4)

getimagesize - получает размер изображения.

Описание

array getimagesize (string filename [, array imageinfo])

Функция getimagesize() определяет размер изображения GIF, JPG, PNG, SWF, PSD, TIFF или BMP и возвращает размеры, тип файла и высоту/ширину текстовой строки, используемой внутри нормального HTML-тэга IMG.

Возвращает массив из 4 элементов. Индекс 0 содержит ширину/width изображения в пикселах. Индекс 1 содержит высоту/height. Индекс 2 это флаг, указывающий тип изображения. 1 = GIF, 2 = JPG, 3 = PNG, 4 = SWF, 5 = PSD, 6 = BMP, 7 = TIFF(байтовый порядок intel), 8 = TIFF(байтовый порядок motorola), 9 = JPC, 10 = JP2, 11 = JPX. Индекс 3 это текстовая строка с корректной строкой height="yyy" width="xxx", которая может использоваться непосредственно в тэге IMG.

getlastmod

(PHP 3, PHP 4)

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

Описание

int getlastmod (void)

Возвращает время последней модификации текущей страницы. Возвращается Unix timestamp, подходящий для использования в date(). Возвращает FALSE при ошибке.

getmxrr

(PHP 3, PHP 4)

getmxrr - получает MX-записи, соответствующие имени данного Internet-хоста.

Описание

int getmxrr (string hostname, array mxhosts [, array weight])

Ищет DNS для MX-записей, соответствующих hostname. Возвращает TRUE, если найдены любые записи; возвращает FALSE, если никаких записей не было найдено или если возникла ошибка.

Список найденных MX-записей помещается в массив mxhosts. Если массив weight задан, он будет заполнен полученной weight-информацией.

См. также checkdnsrr(), gethostbyname(), gethostbynamel() и gethostbyaddr().

getmygid

(PHP 4 >= 4.1.0)

getmygid - получает GID владельца РНР-скрипта.

Описание

int getmygid (void)

Возвращает group ID текущего скрипта или FALSE при ошибке.

См. также getmyuid(), getmypid(), get_current_user(), getmyinode() и getlastmod().

getmyinode

(PHP 3, PHP 4)

getmyinode - получает inode текущего скрипта.

Описание

int getmyinode (void)

Возвращает inode текущего скрипта или FALSE при ошибке.

См. также getmygid(), getmyuid(), get_current_user(), getmypid() и getlastmod().

Примечание: эта функция не реализована для платформ Windows.

getmypid

(PHP 3, PHP 4)

getmypid - получает ID РНР-процесса.

Описание

int getmypid (void)

Возвращает идентификатор ID текущего процесса РНР или FALSE при ошибке.

Предупреждение!Process IDs не являются уникальными, поэтому являются источником некоторой энтропии. Мы рекомендуем не полагаться на pid'ы в контексте безопасности.

См. также getmygid(), getmyuid(), get_current_user(), getmyinode() и getlastmod().

getmyuid

(PHP 3, PHP 4)

getmyuid - получает UID владельца РНР-скрипта.

Описание

int getmyuid (void)

Возвращает user ID текущего скрипта или FALSE при ошибке.

См. также getmygid(), getmypid(), get_current_user(), getmyinode() и getlastmod().

getprotobyname

(PHP 4)

getprotobyname - получает номер протокола, ассоциированный с именем протокола.

Описание

int getprotobyname (string name)

getprotobyname() возвращает номер протокола, ассоциированный с именем name протокола как /etc/protocols.

См. также: getprotobynumber().

getprotobynumber

(PHP 4)

getprotobynumber - получает имя протокола, ассоциированное с номером протокола.

Описание

string getprotobynumber (int number)

getprotobynumber() возвращает имя протокола, ассоциированное с номером number протокола как /etc/protocols.

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

getrandmax

(PHP 3, PHP 4)

getrandmax - показывает наибольшее возможное случайное значение.

Описание

int getrandmax (void)

Возвращает максимальное значение, которое может быть возвращено вызовом функции rand().

См. также rand(), srand() и mt_getrandmax().

getrusage

(PHP 3>= 3.0.7, PHP 4)

getrusage - получает использование текущего ресурса.

Описание

array getrusage ([int who])

Это интерфейс с getrusage(2). Она возвращает ассоциативный массив, содержащий данные, возвращённые системным вызовом. Если who это 1, getrusage будет вызвана с RUSAGE_CHILDREN.

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

getservbyname

(PHP 4)

getservbyname - получает номер порта, ассоциированного с Internet-службой и протоколом.

Описание

int getservbyname (string service, string protocol)

getservbyname() возвращает Internet-порт, который соответствует service для специфицированного protocol как для /etc/services.
protocol это либо "tcp", либо "udp" (в нижнем регистре).

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

getservbyport

(PHP 4)

getservbyport - получает Internet-службу, которая соответствует порту и протоколу.

Описание

string getservbyport (int port, string protocol)

getservbyport() возвращает Internet service, ассоциированный с port для специфицированного protocol как для /etc/services.

protocol это "tcp" или "udp" (в нижнем регистре).

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

gettext

(PHP 3>= 3.0.7, PHP 4)

gettext - ищет сообщение в текущем домене.

Описание

string gettext (string message)

Эта функция возвращает оттранслированную строку, если она найдена в таблице трансляции, или отправленное сообщение, если строка не найдена. Вы можете использовать символ подчёркивания/underscore '_' в качестве псевдонима этой функции.

gettimeofday

(PHP 3>= 3.0.7, PHP 4)

gettimeofday - получает текущее время.

Описание

array gettimeofday (void)

Это интерфейс для gettimeofday(2). Она возвращает ассоциативный массив, содержащий данные, возвращённые системным вызовом.

"sec" - секунды

"usec" - микросекунды

"minuteswest" - минуты к западу от Greenwich

"dsttime" - тип dst-коррекции

gettype

(PHP 3, PHP 4)

gettype - получает тип переменной.

Описание

string gettype (mixed var)

Возвращает тип РНР-переменнойvar.

Предупреждение!Никогда не используйте gettype() для проверки типа, поскольку возвращаемая строка может быть субъектом для изменения в последующих версиях. Кроме того, это слишком медленно, так как выполняется сравнение строк.

Используйте вместо неё функции is_*.

Возможными значениями для возвращаемой строки являются:

" boolean" (начиная с PHP 4)

"integer"

"double" (по историческим соображениям "double" возвращается в случае с float, а не просто "float")

"string"

" array"

"object"

"resource" (начиная с PHP 4)

"NULL" (начиная с PHP 4)

"user function" (только в PHP 3, не рекомендуется)

"unknown type"

Для PHP 4 вы должны использовать function_exists() и method_exists() взамен ранее использовавшейся gettype().

См. также settype(), is_array(), is_bool(), is_float(), is_integer(), is_null(), is_numeric(), is_object(), is_resource(), is_scalar() и is_string().

glob

(только PHP 4 CVS)

glob - находит pathnames, совпадающие с патэрном.

Описание

array glob (string pattern [, int flags])

Функция glob() ищет все pathnames, совпадающие с pattern в соответствии с правилами, используемыми оболочкой/shell. Расширение тильды или замена параметров не выполняются.

Возвращает массив, содержащий совпавшие файлы/директории, или FALSE при ошибке.

Примечание: эта функция отключена в режиме safe mode и, следовательно, всегда будет возвращать FALSE в safe mode.

gmdate

(PHP 3, PHP 4)

gmdate - форматирует GMT/CUT дату/время.

Описание

string gmdate (string format [, int timestamp])

Идентична функции date(), но время возвращается как Greenwich Mean Time (GMT). Например, если запустить в Финляндии (GMT +0200), первая строка из примера напечатает "Jan 01 1998 00:00:00", а вторая - "Dec 31 1997 22:00:00".

gmmktime

(PHP 3, PHP 4)

gmmktime - получает UNIX timestamp для GMT-даты.

Описание

int gmmktime (int hour, int minute, int second, int month, int day, int year [, int is_dst])

Идентична mktime(), но передаваемые параметры представляют GMT-дату.

gmp_abs

(PHP 4 >= 4.0.4)

gmp_abs - абсолютное значение.

Описание

resource gmp_abs (resource a)

Возвращает абсолютное значение для a.

gmp_add

(PHP 4 >= 4.0.4)

gmp_add - добавляет числа.

Описание

resource gmp_add (resource a, resource b)

Добавляет два GMP-числа. Результат будет GMP-числом, представляющим сумму аргументов.

gmp_and

(PHP 4 >= 4.0.4)

gmp_and - логическое И.

Описание

resource gmp_and (resource a, resource b)

Вычисляет логическое AND двух GMP-чисел.

gmp_clrbit

(PHP 4 >= 4.0.4)

gmp_clrbit - очищает бит.

Описание

resource gmp_clrbit (resource &a, int index)

Очищает (устанавливает в 0) бит index в a.

gmp_cmp

(PHP 4 >= 4.0.4)

gmp_cmp - сравнивает числа.

Описание

int gmp_cmp (resource a, resource b)

Возвращает положительное значение, если a > b, нуль, если a = b, и отрицательное, если a < b.

gmp_com

(PHP 4 >= 4.0.4)

gmp_com - вычисляет дополнение для a.

Описание

resource gmp_com (resource a)

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

gmp_div

(PHP 4 >= 4.0.4)

gmp_div - делит числа.

Описание

resource gmp_div (resource a, resource b)

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

gmp_div_q

(PHP 4 >= 4.0.4)

gmp_div_q - делит числа.

Описание

resource gmp_div_q (resource a, resource b [, int round])

Делит a на b и возвращает целочисленный результат. Округление результата определяется параметром round, который может иметь следующие значения:

GMP_ROUND_ZERO: результат округляется в сторону 0.

GMP_ROUND_PLUSINF: результат округляется в сторону +infinity.

GMP_ROUND_MINUSINF: результат округляется в сторону -infinity.

Эта функция может также вызываться как gmp_div().

См. также gmp_div_r(), gmp_div_qr().

gmp_div_qr

(PHP 4 >= 4.0.4)

gmp_div_qr - делит числа и получает частное и остаток.

Описание

array gmp_div_qr (resource n, resource d [, int round])

Функция делит n на d и возвращает массив с первым элементом [n/d] (целочисленным результатом деления) и вторым (n - [n/d] * d) (остатком от деления).

См. в функции gmp_div_q() описание аргумента round.

gmp_div_r

(PHP 4 >= 4.0.4)

gmp_div_r - остаток от деления чисел.

Описание

resource gmp_div_r (resource n, resource d [, int round])

Вычисляет остаток от целочисленного деления n на d. Этот остаток имеет знак аргумента n, если он не нуль.

См. в функции gmp_div_q() описание аргумента round.

См. также gmp_div_q(), gmp_div_qr().

gmp_divexact

(PHP 4 >= 4.0.4)

gmp_divexact - точное деление чисел.

Описание

resource gmp_divexact (resource n, resource d)

Делит n на d, используя быстрый алгоритм "точного деления". Эта функция даёт корректный результаты только тогда, когда заранее известно, что d делит n.

gmp_fact

(PHP 4 >= 4.0.4)

gmp_fact - факториал.

Описание

resource gmp_fact (int a)

Вычисляет факториал (a!) для a.

gmp_gcd

(PHP 4 >= 4.0.4)

gmp_gcd - вычисляет GCD.

Описание

resource gmp_gcd (resource a, resource b)

Вычисляет наибольший общий делитель для a и b. Результат всегда положительный, даже если один или оба операнда отрицательные.

gmp_gcdext

(PHP 4 >= 4.0.4)

gmp_gcdext - вычисляет GCD и множители.

Описание

array gmp_gcdext (resource a, resource b)

Вычисляет g, s и t так, что a*s + b*t = g = gcd(a,b), где gcd является наибольшим общим делителем. Возвращает массив с соответствующими элементами g, s и t.

gmp_hamdist

(PHP 4 >= 4.0.4)

gmp_hamdist - Hamming-расстояние.

Описание

int gmp_hamdist (resource a, resource b)

Возвращает hamming-расстояние между a и b. Оба операнда должны быть неотрицательными.

gmp_init

(PHP 4 >= 4.0.4)

gmp_init - создаёт GMP-число.

Описание

resource gmp_init (mixed number)

Создаёт GMP-число из целого числа или строки. Строковое представление может быть десятеричным или 16-ричным. В последнем случае строка должна начинаться с 0x.

gmp_intval

(PHP 4 >= 4.0.4)

gmp_intval - конвертирует GMP-число в целое.

Описание

int gmp_intval (resource gmpnumber)

Эта функция позволяет конвертировать GMP-число в целое. Предупреждение!Эта функция возвращает пригодный для использования результат только в том случае, если число действительно соответствует целому числу PHP (т.е. тип long со знаком). Если вы хотите просто напечатать GMP-число, используйте gmp_strval().

gmp_invert

(PHP 4 >= 4.0.4)

gmp_invert - инверсия по modulo.

Описание

resource gmp_invert (resource a, resource b)

Вычисляет инверсию a modulo b. Возвращает FALSE, если инверсия не существует.

gmp_jacobi

(PHP 4 >= 4.0.4)

gmp_jacobi - символ Jacobi.

Описание

int gmp_jacobi (resource a, resource p)

Вычисляет Jacobi-символ a и p.
p должно быть нечётным и положительным.

gmp_legendre

(PHP 4 >= 4.0.4)

gmp_legendre - символ Legendre.

Описание

int gmp_legendre (resource a, resource p)

Вычисляет Legendre-символ a и p.p должно быть нечётным и положительным.

gmp_mod

(PHP 4 >= 4.0.4)

gmp_mod - операция Modulo.

Описание

resource gmp_mod (resource n, resource d)

Вычисляет n modulo d. результат всегда неотрицательный, знак d игнорируется.

gmp_mul

(PHP 4 >= 4.0.4)

gmp_mul - умножение чисел.

Описание

resource gmp_mul (resource a, resource b)

Умножает a на b и возвращает результат.

gmp_neg

(PHP 4 >= 4.0.4)

gmp_neg - отрицание числа.

Описание

resource gmp_neg (resource a)

Возвращает -a.

gmp_or

(PHP 4 >= 4.0.4)

gmp_or - логическое ИЛИ.

Описание

resource gmp_or (resource a, resource b)

Вычисляет логическое включающее OR двух GMP-чисел.

gmp_perfect_square

(PHP 4 >= 4.0.4)

gmp_perfect_square - проверка точности квадрата.

Описание

bool gmp_perfect_square (resource a)

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

См. также: gmp_sqrt(), gmp_sqrtrm().

gmp_popcount

(PHP 4 >= 4.0.4)

gmp_popcount - счёт совокупности/Population count.

Описание

int gmp_popcount (resource a)

Возвращает population count a.

gmp_pow

(PHP 4 >= 4.0.4)

gmp_pow - возводит число в степень.

Описание

resource gmp_pow (resource base, int exp)

Возводит base в степень exp. В случае 0^0 даёт 1.
exp не может быть отрицательной.

gmp_powm

(PHP 4 >= 4.0.4)

gmp_powm - возводит число в степень с modulo.

Описание

resource gmp_powm (resource base, resource exp, resource mod)

Вычисляет base, возведённую в степень exp, modulo mod. Если exp отрицательная, результат не определён.

gmp_prob_prime

(PHP 4 >= 4.0.4)

gmp_prob_prime - проверяет, является ли число "probably prime/возможно простым числом".

Описание

int gmp_prob_prime (resource a [, int reps])

Если эта функция возвращает 0, a определено не простое число. Если возвращает 1, a является "вероятно" простым числом. Если возвращает 2, a наверняка является простым. Имеют смысл значения reps от 5 до 10 (по умолчанию 10); более высокое значение уменьшает вероятность не-простого числа пройти как "probable" prime.

Функция использует тест вероятности Miller'а-Rabin'а.

gmp_random

(PHP 4 >= 4.0.4)

gmp_random - случайное число.

Описание

resource gmp_random (int limiter)

Генерирует случайное число. Это число будет в диапазоне от limiter до нуля. Если limiter отрицательный, генерируются отрицательные числа.

gmp_scan0

(PHP 4 >= 4.0.4)

gmp_scan0 - сканирует 0.

Описание

int gmp_scan0 (resource a, int start)

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

gmp_scan1

(PHP 4 >= 4.0.4)

gmp_scan1 - сканирует 1.

Описание

int gmp_scan1 (resource a, int start)

Сканирует a, начиная с бита start, по направлению к более значащим битам, пока не будет найден первый установленный бит. Возвращает индекс найденного бита.

gmp_setbit

(PHP 4 >= 4.0.4)

gmp_setbit - устанавливает бит.

Описание

resource gmp_setbit (resource &a, int index [, bool set_clear])

Устанавливает бит index в a.
set_clear определяет, устанавливается в бит 0 или 1. По умолчанию в бит устанавливается 1.

gmp_sign

(PHP 4 >= 4.0.4)

gmp_sign - знак числа.

Описание

int gmp_sign (resource a)

Возвращает знак числа a. 1, если a является положительным, и -1, если отрицательным.

gmp_sqrt

(PHP 4 >= 4.0.4)

gmp_sqrt - квадратный корень.

Описание

resource gmp_sqrt (resource a)

Вычисляет квадратный корень a.

gmp_sqrtrm

(unknown)

gmp_sqrtrm - квадратный корень с остатком.

Описание

array gmp_sqrtrm (resource a)

Возвращает массив, где первый элемент является целочисленным квадратным корнем a (см. также gmp_sqrt()), а второй - остатком (т.е. разницей между a и первым элементом).

gmp_sqrtrm

(unknown)

gmp_sqrtrm - квадратный корень с остатком.

Описание

array gmp_sqrtrm (resource a)

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

gmp_strval

(PHP 4 >= 4.0.4)

gmp_strval - конвертирует GMP-число в строку.

Описание

string gmp_strval (resource gmpnumber [, int base])

Конвертирует GMP-число в строковое представление с базой base. По умолчанию base равна 10. Допустимые значения для base - от 2 до 36.

gmp_sub

(PHP 4 >= 4.0.4)

gmp_sub - вычитает числа.

Описание

resource gmp_sub (resource a, resource b)

Вычитает из b из a и возвращает результат.

gmp_xor

(PHP 4 >= 4.0.4)

gmp_xor - логическое XOR (исключающее ИЛИ).

Описание

resource gmp_xor (resource a, resource b)

Вычисляет логическое исключающее ИЛИ (XOR) двух GMP-чисел.

gmstrftime

(PHP 3>= 3.0.12, PHP 4 )

gmstrftime - форматирует GMT/CUT время/дату в соответствии с локальными установками.

Описание

string gmstrftime (string format [, int timestamp])

Работает так же, как strftime(), но время возвращается как Greenwich Mean Time (GMT). Например, при запуске под Eastern Standard Time (GMT -0500),первая строка примера выведет "Dec 31 1998 20:00:00", а вторая напечатает "Jan 01 1999 01:00:00".

GregorianToJD

(PHP 3, PHP 4 )

GregorianToJD - конвертирует григорианскую дату в юлианское летосчисление/Julian Day Count.

Описание

int gregoriantojd (int month, int day, int year)

Верный диапазон Григорианского календаря от 4714 до Р.Х. до 9999 Н.Э.

Хотя эта функция может работать с датами, более ранними, чем 4714 до Р.Х., такое использование не имеет смысла. Григорианский календарь не существовал до даты 15 октября 1582 года (или 5 октября 1582 года, по Юлианскому календарю). Некоторые страны не принимали его ещё дольше. Например, Британия перешла в 1752, СССР - в 1918, а Греция - в 1923 году. Большинство европейских стран использовали Юлианский календарь до Григорианского.

Пример 1. Календарные функции

<?php
$jd = GregorianToJD (10,11,1970);
echo "$jd\n";
$gregorian = JDToGregorian ($jd);
echo "$gregorian\n";
?>