cvs: phpdoc-ru /language references.xml

From: Date: Tue, 22 Apr 2008 14:21:21 +0000
Subject: cvs: phpdoc-ru /language references.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-939@lists.php.net to get a copy of this message
tony2001 Tue Apr 22 14:21:21 2008 UTC Modified files: /phpdoc-ru/language references.xml Log: nuke long lines

http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/references.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-ru/language/references.xml diff -u phpdoc-ru/language/references.xml:1.4 phpdoc-ru/language/references.xml:1.5 --- phpdoc-ru/language/references.xml:1.4 Tue Apr 22 14:15:48 2008 +++ phpdoc-ru/language/references.xml Tue Apr 22 14:21:20 2008 @@ -1,20 +1,27 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.50 Status: ready --> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <chapter xml:id="language.references" xmlns="http://docbook.org/ns/docbook"> <title>Ссылки. Разъяснения</title> <sect1 xml:id="language.references.whatare"> <title>Что такое ссылки</title> <simpara> - Ссылки в PHP - это средство доступа к содержимому одной переменной под разными именами. Они не похожи на указатели C и не являются псевдонимами таблицы символов. В PHP имя переменной и её содержимое - это разные вещи, поэтому одно содержимое может иметь разные имена. Ближайшая аналогия - имена файлов Unix и файлы - имена переменных являются элементами каталогов, а содержимое переменных это сами файлы. Ссылки в PHP - аналог жёстких ссылок (hardlinks) в файловых системах Unix. + Ссылки в PHP - это средство доступа к содержимому одной переменной под + разными именами. Они не похожи на указатели C и не являются псевдонимами + таблицы символов. В PHP имя переменной и её содержимое - это разные вещи, + поэтому одно содержимое может иметь разные имена. Ближайшая аналогия - + имена файлов Unix и файлы - имена переменных являются элементами + каталогов, а содержимое переменных это сами файлы. Ссылки в PHP - аналог + жёстких ссылок (hardlinks) в файловых системах Unix. </simpara> </sect1> <sect1 xml:id="language.references.whatdo"> <title>Что делают ссылки</title> <para> - Ссылки в PHP дают возможность двум переменным ссылаться на одно содержимое. Например: + Ссылки в PHP дают возможность двум переменным ссылаться на одно + содержимое. Например: <informalexample> <programlisting role="php"> <![CDATA[ @@ -24,10 +31,13 @@ ]]> </programlisting> </informalexample> - означает, что <varname>$a</varname> указывает на то же содержание, что и <varname>$b</varname>. + означает, что <varname>$a</varname> указывает на то же содержание, + что и <varname>$b</varname>. <note> <para> - <varname>$a</varname> и <varname>$b</varname> здесь абсолютно эквивалентны, но это не означает, что $a указывает на $b или наоборот. Это означает, что $a и $b указывают на одно место. + <varname>$a</varname> и <varname>$b</varname> здесь абсолютно эквивалентны, + но это не означает, что $a указывает на $b или наоборот. Это означает, что + $a и $b указывают на одно место. </para> </note> </para> @@ -37,7 +47,7 @@ Это также касается массивов, передаваемых функциям по значению. </para> </note> -<note> + <note> <para> Если вы возвращаете из функции ссылку на неинициализированную переменную - она будет создана. @@ -65,7 +75,8 @@ </note> <para> - Такой же синтаксис можно использовать и в функциях, возвращая ссылки, а так же в операторе <literal>new</literal> (начиная с PHP 4.0.4): + Такой же синтаксис можно использовать и в функциях, возвращая ссылки, + а так же в операторе <literal>new</literal> (начиная с PHP 4.0.4): <informalexample> <programlisting role="php"> <![CDATA[ @@ -80,19 +91,26 @@ <note> <para> Если опустить <literal>&amp;</literal>, это приведёт к копированию объекта. - Если вы используете <literal>$this</literal> в классе, операция проводится над текущим экземпляром этого класса. - Присвоение без <literal>&amp;</literal> приведёт к копированию экземпляра, и <literal>$this</literal> будет работать с копией, что не всегда желательно. - Обычно, вам нужно иметь один экземпляр, из соображений производительности и использования памяти. + Если вы используете <literal>$this</literal> в классе, операция + проводится над текущим экземпляром этого класса. Присвоение без + <literal>&amp;</literal> приведёт к копированию экземпляра, и + <literal>$this</literal> будет работать с копией, что не всегда + желательно. Обычно, вам нужно иметь один экземпляр, из соображений + производительности и использования памяти. </para> <para> - Операция <literal>@</literal>, которая <emphasis>скрывает</emphasis> сообщения об ошибках, например в конструкторе <literal>@new</literal>, не может быть использована совместно с операцией <literal>&amp;</literal> (<literal>&amp;new</literal>). - Это ограничение интерпретатора Zend. + Операция <literal>@</literal>, которая <emphasis>скрывает</emphasis> + сообщения об ошибках, например в конструкторе <literal>@new</literal>, + не может быть использована совместно с операцией + <literal>&amp;</literal> (<literal>&amp;new</literal>). + Это ограничение Zend Engine. </para> </note> <warning> <para> - Если переменной, объявленной внутри функции как <literal>global</literal>, будет присвоена ссылка, она будет видна только в функции. - Чтобы избежать это, воспользуйтесь массивом <varname>$GLOBALS</varname>. + Если переменной, объявленной внутри функции как + <literal>global</literal>, будет присвоена ссылка, она будет видна только + в функции. Чтобы избежать этого, используйте массив <varname>$GLOBALS</varname>. <example> <title>Присвоение ссылок глобальным переменным внутри функции</title> <programlisting role="php"> @@ -119,7 +137,10 @@ ]]> </programlisting> </example> - Думайте о <literal>global $var;</literal> как о сокращении от <literal>$var =&amp; $GLOBALS['var'];</literal>. Таким образом, присвоение <literal>$var</literal> другой ссылки влияет лишь на локальную переменную. + Думайте о <literal>global $var;</literal> как о сокращении от + <literal>$var =&amp; $GLOBALS['var'];</literal>. Таким образом, + присвоение <literal>$var</literal> другой ссылки влияет лишь на локальную + переменную. </para> </warning> <note> @@ -146,7 +167,8 @@ </note> <warning> <para> - Сложные массивы в некоторых случаях могут копироваться вместо создания ссылок. например, следующий пример не будет работать как ожидалось. + Сложные массивы в некоторых случаях могут копироваться вместо создания + ссылок. например, следующий пример не будет работать как ожидалось. <example> <title>Ссылки и сложные массивы</title> <programlisting role="php"> @@ -170,9 +192,9 @@ </para> </warning> <para> - Второе, что делают ссылки - передача параметров по ссылке. - При этом локальная переменная в функции и переменная в области видимости вызывателя ссылаются на одно и то же содержимое. - Пример: + Второе, что делают ссылки - передача параметров по ссылке. При этом + локальная переменная в функции и переменная в области видимости вызывателя + ссылаются на одно и то же содержимое. Пример: <informalexample> <programlisting role="php"> <![CDATA[ @@ -188,8 +210,11 @@ ]]> </programlisting> </informalexample> - Этот код присвоит <varname>$a</varname> значение 6. Это происходит, потому что в функции <varname>foo</varname> переменная <varname>$var</varname> ссылается на то же содержимое, что и переменная <varname>$a</varname>. См. также детальное объяснение <link - linkend="language.references.pass">передачи по ссылке</link>. + Этот код присвоит <varname>$a</varname> значение 6. Это происходит, потому + что в функции <varname>foo</varname> переменная <varname>$var</varname> + ссылается на то же содержимое, что и переменная <varname>$a</varname>. См. + также детальное объяснение + <link linkend="language.references.pass">передачи по ссылке</link>. </para> <simpara> Третье, что могут ссылки - <link @@ -200,7 +225,8 @@ <sect1 xml:id="language.references.arent"> <title>Чем ссылки не являются</title> <para> - Как уже было сказано, ссылки не являются указателями. Это означает, что следующая конструкция не будет делать то, что вы ожидаете: + Как уже было сказано, ссылки не являются указателями. Это означает, что + следующая конструкция не будет делать то, что вы ожидаете: <informalexample> <programlisting role="php"> <![CDATA[ @@ -216,17 +242,23 @@ </informalexample> </para> <simpara> - Переменная <varname>$var</varname> в фукнции <varname>foo</varname> будет связана с <varname>$bar</varname> в вызывателе, но затем она будет перепривязана к <varname>$GLOBALS["baz"]</varname>. - Нет способа связать <varname>$bar</varname> в области видимости вызывателя с чем-либо ещё путём использования механизма ссылок, поскольку <varname>$bar</varname> не доступна в функции <varname>foo</varname> (доступно лишь её значение через - <varname>$var</varname>). - Вы можете воспользоваться <link linkend="language.references.return">возвращением ссылок</link> из функции для привязки внешней перменной к другому значению. + Переменная <varname>$var</varname> в фукнции <varname>foo</varname> будет + связана с <varname>$bar</varname> в вызывателе, но затем она будет + перепривязана к <varname>$GLOBALS["baz"]</varname>. Нет способа связать + <varname>$bar</varname> в области видимости вызывателя с чем-либо ещё + путём использования механизма ссылок, поскольку <varname>$bar</varname> не + доступна в функции <varname>foo</varname> (доступно лишь её значение через + <varname>$var</varname>). Вы можете воспользоваться <link + linkend="language.references.return">возвращением ссылок</link> из + функции для привязки внешней перменной к другому значению. </simpara> </sect1> <sect1 xml:id="language.references.pass"> <title>Передача по ссылке</title> <para> - Вы можете передавать переменные в функцию по ссылке, и функция сможет изменять свои аргументы. Синтаксис таков: + Вы можете передавать переменные в функцию по ссылке, и функция сможет + изменять свои аргументы. Синтаксис таков: <informalexample> <programlisting role="php"> <![CDATA[ @@ -243,7 +275,9 @@ ]]> </programlisting> </informalexample> - Заметьте, что в вызове функции отсутствует знак ссылки - он есть только в определении функции. Этого достаточно для корректной передачи аргументов по ссылке. + Заметьте, что в вызове функции отсутствует знак ссылки - он есть только в + определении функции. Этого достаточно для корректной передачи аргументов по + ссылке. </para> <para> По ссылке можно передавать: @@ -282,7 +316,8 @@ </itemizedlist> </para> <para> - Любое другое выражение не должно передаваться по ссылке, так как результат не определён. Например, следующая передача по ссылке является неправильной: + Любое другое выражение не должно передаваться по ссылке, так как результат + не определён. Например, следующая передача по ссылке является неправильной: <informalexample> <programlisting role="php"> <![CDATA[ @@ -307,7 +342,9 @@ <sect1 xml:id="language.references.return"> <title>Возвращение по ссылке</title> <para> - Возвращение по ссылке используется в тех случаях, когда вы хотите использовать функцию для выбора переменной, с которой должна быть связана данная ссылка. При возвращении по ссылке используйте такой синтаксис: + Возвращение по ссылке используется в тех случаях, когда вы хотите + использовать функцию для выбора переменной, с которой должна быть связана + данная ссылка. При возвращении по ссылке используйте такой синтаксис: <informalexample> <programlisting role="php"> <![CDATA[ @@ -324,11 +361,16 @@ ]]> </programlisting> </informalexample> - В этом примере устанавливается свойство объекта, возвращённого функцией <varname>find_var</varname>, а не его копии, как было бы без использования ссылок. + В этом примере устанавливается свойство объекта, возвращённого функцией + <varname>find_var</varname>, а не его копии, как было бы без использования + ссылок. </para> <note> <simpara> - В отличие от передачи параметров по ссылке, <literal>&amp;</literal> здесь нужно использовать в обоих местах - для указания на то, что вы возвращаете ссылку, а не копию, как обычно, и для указания того, что происходит связывание по ссылке, а не обычное присвоение. + В отличие от передачи параметров по ссылке, <literal>&amp;</literal> + здесь нужно использовать в обоих местах - для указания на то, что вы + возвращаете ссылку, а не копию, как обычно, и для указания того, что + происходит связывание по ссылке, а не обычное присвоение. </simpara> </note> <note> @@ -348,7 +390,9 @@ <sect1 xml:id="language.references.unset"> <title>Сброс переменных-ссылок</title> <para> - При сбросе ссылки, просто разрывается связь имени и содержимого переменной. Это не означает, что содержимое переменной будет разрушено. Например: + При сбросе ссылки, просто разрывается связь имени и содержимого + переменной. Это не означает, что содержимое переменной будет разрушено. + Например: <informalexample> <programlisting role="php"> <![CDATA[ @@ -371,13 +415,18 @@ <sect1 xml:id="language.references.spot"> <title>Неявное использование механизма ссылок</title> <simpara> - Многие синтаксические конструкции PHP реализованы через механизм ссылок, поэтому всё сказанное выше о ссылочном связывании применимо также и к этим конструкциям. Некоторые конструкции, вроде передающих и возвращающих по ссылке, рассмотрены ранее. Другие конструкции, использующие ссылки: + Многие синтаксические конструкции PHP реализованы через механизм ссылок, + поэтому всё сказанное выше о ссылочном связывании применимо также и к этим + конструкциям. Некоторые конструкции, вроде передающих и возвращающих по + ссылке, рассмотрены ранее. Другие конструкции, использующие ссылки: </simpara> <sect2 xml:id="references.global"> <title>Ссылки <literal>global</literal></title> <para> - Если вы объявляете переменную как <command>global $var</command>, вы фактически создаёте ссылку на глобальную переменную. Это означает то же самое, что: + Если вы объявляете переменную как <command>global $var</command>, вы + фактически создаёте ссылку на глобальную переменную. Это означает то же + самое, что и: <informalexample> <programlisting role="php"> <![CDATA[ @@ -389,14 +438,16 @@ </informalexample> </para> <simpara> - Это значит, например, что сброс (unset) <varname>$var</varname> не приведёт к сбросу глобальной переменной. + Это значит, например, что сброс (unset) <varname>$var</varname> не + приведёт к сбросу глобальной переменной. </simpara> </sect2> <sect2 xml:id="references.this"> <title><literal>$this</literal></title> <simpara> - В методах объекта, <varname>$this</varname> всегда является ссылкой на вызывающий объект. + В методах объекта, <varname>$this</varname> всегда является ссылкой на + вызывающий объект. </simpara> </sect2> </sect1>
« previous php.doc.ru (#939) next »