svn: /phpdoc/bg/trunk/appendices/ comparisons.xml reserved.constants.core.xml
[email protected] (Stanislav Yordanov) Sat, 16 Jan 2016 21:32:45 +0000
| Newsgroups | php.doc.bg |
|---|---|
| Message-ID | <[email protected]> |
stanprog Sat, 16 Jan 2016 21:32:45 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=338517
Log:
sync to EN
Changed paths:
U phpdoc/bg/trunk/appendices/comparisons.xml
U phpdoc/bg/trunk/appendices/reserved.constants.core.xml
svn-diffs-338517.txt
(text/x-diff, 19.7 KB)
Modified: phpdoc/bg/trunk/appendices/comparisons.xml
===================================================================
--- phpdoc/bg/trunk/appendices/comparisons.xml 2016-01-16 17:42:07 UTC (rev 338516)
+++ phpdoc/bg/trunk/appendices/comparisons.xml 2016-01-16 21:32:45 UTC (rev 338517)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 338385 Maintainer: stanprog Status: ready -->
<appendix xml:id="types.comparisons" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Таблици за сравнение на типове в PHP</title>
<para>
@@ -33,11 +33,22 @@
<para>
Ако напишете <literal>if ($x)</literal>, а <varname>$x</varname> е
недефинирана променлива, това ще доведе до генериране на грешка от ниво <constant>E_NOTICE</constant>.
- Вмосто това, можете да използвате функциите <function>empty</function> или
+ Вместо това, можете да използвате функциите <function>empty</function> или
<function>isset</function> и/или да инициализирате
променливите, които използвате.
</para>
</note>
+ <note>
+ <para>
+ Някои числови операции могат да върнат стойност, представена чрез константата
+ <constant>NAN</constant>. Всяко обикновено или стриктно сравнение на тази стойност
+ с друга стойност, в това число и с нея самата, ще върне &false;.
+ (т.е. <literal>NAN != NAN</literal> и <literal>NAN !== NAN</literal>)
+ Примерни операции които връщат <constant>NAN</constant> са
+ <literal>sqrt(-1)</literal>, <literal>asin(2)</literal> и
+ <literal>asinh(0)</literal>.
+ </para>
+ </note>
<para>
<table>
<title>Сравняване на <varname>$x</varname> с функции на PHP</title>
@@ -52,7 +63,7 @@
<entry><type>boolean</type> : <literal>if($x)</literal></entry>
</row>
</thead>
- <tbody>
+<tbody>
<row>
<entry><literal>$x = "";</literal></entry>
<entry><type>string</type></entry>
@@ -94,6 +105,14 @@
<entry>&false;</entry>
</row>
<row>
+ <entry><literal>$x = array('a', 'b');</literal></entry>
+ <entry><type>array</type></entry>
+ <entry>&false;</entry>
+ <entry>&false;</entry>
+ <entry>&true;</entry>
+ <entry>&true;</entry>
+ </row>
+ <row>
<entry><literal>$x = false;</literal></entry>
<entry><type>boolean</type></entry>
<entry>&true;</entry>
@@ -193,11 +212,11 @@
</tgroup>
</table>
</para>
-
+
<para>
<table xml:id="types.comparisions-loose">
<title>Обикновени сравнения с <literal>==</literal></title>
- <tgroup cols="12">
+<tgroup cols="12">
<thead>
<row>
<entry> </entry>
@@ -400,11 +419,11 @@
</tgroup>
</table>
</para>
-
+
<para>
<table xml:id="type.comparisons-strict">
<title>Стриктни сравнения с <literal>===</literal></title>
- <tgroup cols="12">
+<tgroup cols="12">
<thead>
<row>
<entry> </entry>
Modified: phpdoc/bg/trunk/appendices/reserved.constants.core.xml
===================================================================
--- phpdoc/bg/trunk/appendices/reserved.constants.core.xml 2016-01-16 17:42:07 UTC (rev 338516)
+++ phpdoc/bg/trunk/appendices/reserved.constants.core.xml 2016-01-16 21:32:45 UTC (rev 338517)
@@ -1,80 +1,89 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 337472 Maintainer: stanprog Status: ready -->
<sect2 xml:id="reserved.constants.core" xmlns="http://docbook.org/ns/docbook">
<title>Константи на ядрото</title>
<simpara>
- Тези константи са дефинирани от ядрото на PHP. Това включва
- PHP, Zend engine и SAPI модулите.
+ Тези константи са дефинирани от ядрото на PHP. Това включва PHP,
+ Zend engine и SAPI модулите.
</simpara>
<variablelist>
- <varlistentry>
+ <varlistentry xml:id="constant.php-version">
<term>
<constant>PHP_VERSION</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
-
+ Текущата версия на PHP във вид на низ
+ във вида „major.minor.release[extra]“.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-major-version">
<term>
<constant>PHP_MAJOR_VERSION</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 5.2.7.
+ Текущата „major“ версия на PHP във вид на цяло число (т.е. int(5)
+ от версия „5.2.7-extra“). Достъпна от PHP 5.2.7
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-minor-version">
<term>
<constant>PHP_MINOR_VERSION</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 5.2.7.
+ Текущата „minor“ версия на PHP във вид на цяло число (т.е. int(2)
+ от версия „5.2.7-extra“). Достъпна от PHP 5.2.7.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-release-version">
<term>
<constant>PHP_RELEASE_VERSION</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 5.2.7.
+ Текущата „release“ версия на PHP във вид на цяло число (т.е. int(7)
+ от версия „5.2.7-extra“). Достъпна от PHP 5.2.7.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-version-id">
<term>
<constant>PHP_VERSION_ID</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
+ Текущата версия на PHP във вид на цяло число, удобно за
+ сравнение на версии (напр. int(50207) от версия „5.2.7-extra“).
Достъпна от PHP 5.2.7.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-extra-version">
<term>
<constant>PHP_EXTRA_VERSION</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 5.2.7.
+ Текущата „extra“ версия на PHP във вид на низ (например, '-extra'
+ от версия „5.2.7-extra“). Обикновено се използва в различни
+ дистрибуции за да укаже версията на пакета. Достъпна от
+ PHP 5.2.7.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-zts">
<term>
<constant>PHP_ZTS</constant>
(<type>integer</type>)
@@ -85,7 +94,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-debug">
<term>
<constant>PHP_DEBUG</constant>
(<type>integer</type>)
@@ -96,18 +105,19 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-maxpathlen">
<term>
<constant>PHP_MAXPATHLEN</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 5.3.0.
+ Максималната дължина на файловите имена (включително пътя) поддържана
+ от текущата компилация на PHP. Достъпна от PHP 5.3.0.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-os">
<term>
<constant>PHP_OS</constant>
(<type>string</type>)
@@ -118,51 +128,67 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-sapi">
<term>
<constant>PHP_SAPI</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 4.2.0. Вж. също <function>php_sapi_name</function>.
+ Сървърният API в текущата компилация на PHP.
+ Вж. също <function>php_sapi_name</function>.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-eol">
<term>
<constant>PHP_EOL</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 4.3.10 и PHP 5.0.2
+ Правилния символ за 'Край на ред' за тази платформа.
+ Достъпна от PHP 5.0.2
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-int-max">
<term>
<constant>PHP_INT_MAX</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 4.4.0 и PHP 5.0.5
+ Най-голямото цяло число поддържано в текущата компилация на PHP. Обикновено int(2147483647).
+ Достъпна от PHP 5.0.5
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-int-min">
<term>
+ <constant>PHP_INT_MIN</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Най-малкото цяло число поддържано в текущата компилация на PHP. Обикновено int(-2147483648) в 32-битови и
+ int(-9223372036854775808) в 64-битови системи. Достъпна от PHP 7.0.0.
+ Обикновено PHP_INT_MIN === ~PHP_INT_MAX.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.php-int-size">
+ <term>
<constant>PHP_INT_SIZE</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 4.4.0 и PHP 5.0.5
+ Размерът на целочисления тип в байтове в текущата компилация на PHP. Достъпна от PHP 5.0.5
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.default-include-path">
<term>
<constant>DEFAULT_INCLUDE_PATH</constant>
(<type>string</type>)
@@ -173,7 +199,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.pear-install-dir">
<term>
<constant>PEAR_INSTALL_DIR</constant>
(<type>string</type>)
@@ -184,7 +210,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.pear-extension-dir">
<term>
<constant>PEAR_EXTENSION_DIR</constant>
(<type>string</type>)
@@ -195,7 +221,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-extension-dir">
<term>
<constant>PHP_EXTENSION_DIR</constant>
(<type>string</type>)
@@ -206,53 +232,55 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-prefix">
<term>
<constant>PHP_PREFIX</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 4.3.0
+ Стойността на опция „--prefix“, указана при пускането на configure.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-bindir">
<term>
<constant>PHP_BINDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
-
+ Указва пътя до инсталираните изпълними файлове.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-binary">
<term>
- <constant>PHP_LIBDIR</constant>
+ <constant>PHP_BINARY</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
-
+ Указва пътя до изпълнимия файл на PHP по време на изпълнение на скрипта.
+ Достъпна от PHP 5.4.
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-mandir">
<term>
- <constant>PHP_DATADIR</constant>
+ <constant>PHP_MANDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
-
+ Указва пътя до инсталираните файлове от man документацията.
+ Достъпна от PHP 5.3.7.
</simpara>
</listitem>
- </varlistentry>
- <varlistentry>
+ </varlistentry>
+ <varlistentry xml:id="constant.php-libdir">
<term>
- <constant>PHP_SYSCONFDIR</constant>
+ <constant>PHP_LIBDIR</constant>
(<type>string</type>)
</term>
<listitem>
@@ -261,9 +289,9 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-datadir">
<term>
- <constant>PHP_LOCALSTATEDIR</constant>
+ <constant>PHP_DATADIR</constant>
(<type>string</type>)
</term>
<listitem>
@@ -272,9 +300,9 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-sysconfdir">
<term>
- <constant>PHP_CONFIG_FILE_PATH</constant>
+ <constant>PHP_SYSCONFDIR</constant>
(<type>string</type>)
</term>
<listitem>
@@ -283,9 +311,9 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-localstatedir">
<term>
- <constant>PHP_CONFIG_FILE_SCAN_DIR</constant>
+ <constant>PHP_LOCALSTATEDIR</constant>
(<type>string</type>)
</term>
<listitem>
@@ -294,32 +322,21 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-config-file-path">
<term>
- <constant>PHP_SHLIB_SUFFIX</constant>
+ <constant>PHP_CONFIG_FILE_PATH</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 4.3.0
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>PHP_OUTPUT_HANDLER_START</constant>
- (<type>integer</type>)
- </term>
- <listitem>
- <simpara>
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-config-file-scan-dir">
<term>
- <constant>PHP_OUTPUT_HANDLER_CONT</constant>
- (<type>integer</type>)
+ <constant>PHP_CONFIG_FILE_SCAN_DIR</constant>
+ (<type>string</type>)
</term>
<listitem>
<simpara>
@@ -327,29 +344,30 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.php-shlib-suffix">
<term>
- <constant>PHP_OUTPUT_HANDLER_END</constant>
- (<type>integer</type>)
+ <constant>PHP_SHLIB_SUFFIX</constant>
+ (<type>string</type>)
</term>
<listitem>
<simpara>
-
+ Наставка, използвана за динамично свързаните библиотеки, като „so“
+ (характерна за повечето Unix-системи) или „sll“ (Windows).
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-error">
<term>
<constant>E_ERROR</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
-
+ <link linkend="errorfunc.constants">Константа на докладването за грешки</link>
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-warning">
<term>
<constant>E_WARNING</constant>
(<type>integer</type>)
@@ -360,7 +378,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-parse">
<term>
<constant>E_PARSE</constant>
(<type>integer</type>)
@@ -371,7 +389,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-notice">
<term>
<constant>E_NOTICE</constant>
(<type>integer</type>)
@@ -382,7 +400,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-core-error">
<term>
<constant>E_CORE_ERROR</constant>
(<type>integer</type>)
@@ -393,7 +411,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-core-warning">
<term>
<constant>E_CORE_WARNING</constant>
(<type>integer</type>)
@@ -404,7 +422,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-compile-error">
<term>
<constant>E_COMPILE_ERROR</constant>
(<type>integer</type>)
@@ -415,7 +433,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-compile-warning">
<term>
<constant>E_COMPILE_WARNING</constant>
(<type>integer</type>)
@@ -426,7 +444,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-user-error">
<term>
<constant>E_USER_ERROR</constant>
(<type>integer</type>)
@@ -437,7 +455,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-user-warning">
<term>
<constant>E_USER_WARNING</constant>
(<type>integer</type>)
@@ -448,7 +466,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-user-notice">
<term>
<constant>E_USER_NOTICE</constant>
(<type>integer</type>)
@@ -459,7 +477,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-deprecated">
<term>
<constant>E_DEPRECATED</constant>
(<type>integer</type>)
@@ -470,7 +488,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-user-deprecated">
<term>
<constant>E_USER_DEPRECATED</constant>
(<type>integer</type>)
@@ -481,7 +499,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-all">
<term>
<constant>E_ALL</constant>
(<type>integer</type>)
@@ -492,18 +510,18 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.e-strict">
<term>
<constant>E_STRICT</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
- Достъпна от PHP 5.0.0
+
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.compiler-halt-offset">
<term>
<constant>__COMPILER_HALT_OFFSET__</constant>
(<type>integer</type>)
@@ -514,7 +532,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.true">
<term>
&true;
(<type>boolean</type>)
@@ -525,7 +543,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.false">
<term>
&false;
(<type>boolean</type>)
@@ -536,7 +554,7 @@
</simpara>
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry xml:id="constant.null">
<term>
&null;
(<type>boolean</type>)