svn: /phpdoc/ru/trunk/language/types/ pseudo-types.xml

From: Date: Mon, 18 Oct 2010 11:31:00 +0000
Subject: svn: /phpdoc/ru/trunk/language/types/ pseudo-types.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1107@lists.php.net to get a copy of this message
conf Mon, 18 Oct 2010 11:31:00 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=304481 Log: Renewed pseudo-types translation. Changed paths: A + phpdoc/ru/trunk/language/types/pseudo-types.xml (from phpdoc/en/trunk/language/types/pseudo-types.xml:r304409) Copied: phpdoc/ru/trunk/language/types/pseudo-types.xml (from rev 304409, phpdoc/en/trunk/language/types/pseudo-types.xml) =================================================================== --- phpdoc/ru/trunk/language/types/pseudo-types.xml (rev 0) +++ phpdoc/ru/trunk/language/types/pseudo-types.xml 2010-10-18 11:31:00 UTC (rev 304481) @@ -0,0 +1,212 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: 293478 Maintainer: conf Status: ready --> +<!-- Reviewed: no --> +<!-- $Id$ --> +<sect1 xml:id="language.pseudo-types"> + <title>Псевдо-типы и переменные, используемые в этой документации</title> + + <sect2 xml:id="language.types.mixed"> + <title>mixed</title> + + <para> + <literal>mixed</literal> говорит о том, что параметр может принимать много + (но необязательно все) типов. + </para> + + <para> + <function>gettype</function> например, принимает все типы PHP, тогда как + <function>str_replace</function> принимает только <type>string</type> и + <type>array</type>. + </para> + + </sect2> + + <sect2 xml:id="language.types.number"> + <title>number</title> + + <para> + <literal>number</literal> говорит о том, что параметр может быть либо + <type>integer</type>, либо <type>float</type>. + </para> + + </sect2> + + <sect2 xml:id="language.types.callback"> + <title>callback</title> + + <para> + Некоторые функции, такие как <function>call_user_func</function> или + <function>usort</function> принимают в качестве параметра определенные пользователем + callback-функции. Callback-функции могут быть не только простыми функциями, но также и + методами объектов, включая статические методы классов. + </para> + + <para> + PHP-функция передается просто как строка ее имени. Можно использовать любую + встроенную или пользовательскую функцию, кроме языковых конструкций, таких как: + <function>array</function>, <function>echo</function>, + <function>empty</function>, <function>eval</function>, + <function>exit</function>, <function>isset</function>, + <function>list</function>, <function>print</function> и + <function>unset</function>. + </para> + + <para> + Метод созданного объекта передается как массив, содержащий сам объект в элементе + с индексом 0 и имя метода в элементе с индексом 1. + </para> + + <para> + Статические методы классов также могут быть переданы без создания экземпляра объекта + данного класса путем передачи имени класса вместо имени объекта в элементе с индексом 0. + </para> + + <para> + Кроме общих пользовательских функций, <function>create_function</function> + также может быть использована для создания анонимной callback-функции. + Начиная с версии PHP 5.3.0 стала возможным также передача + <link linkend="functions.anonymous">замыканий</link> в callback-параметр. + </para> + + <para> + <example> + <title> + Примеры callback-функций + </title> + <programlisting role="php"> +<![CDATA[ +<?php + +// пример callback-функции +function my_callback_function() { + echo 'hello world!'; +} + +// пример callback-метода +class MyClass { + static function myCallbackMethod() { + echo 'Hello World!'; + } +} + +// Вариант 1: простой вызов callback +call_user_func('my_callback_function'); + +// Вариант 2: вызов статического метода класса +call_user_func(array('MyClass', 'myCallbackMethod')); + +// Вариант 3: вызов метода объекта +$obj = new MyClass(); +call_user_func(array($obj, 'myCallbackMethod')); + +// Вариант 4: вызов статического метода класса (с версии PHP 5.2.3) +call_user_func('MyClass::myCallbackMethod'); + +// Вариант 5: вызов относительного статического метода класса (с версии PHP 5.3.0) +class A { + public static function who() { + echo "A\n"; + } +} + +class B extends A { + public static function who() { + echo "B\n"; + } +} + +call_user_func(array('B', 'parent::who')); // A +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title> + Пример callback-вызова с использованием замыканий + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// наше замыкание +$double = function($a) { + return $a * 2; +}; + +// это наш диапазон чисел +$numbers = range(1, 5); + +// Используем здесь замыкание в качестве callback-функции +// для удвоения размера каждого элемента в диапазоне +$new_numbers = array_map($double, $numbers); + +print implode(' ', $new_numbers); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +2 4 6 8 10 +]]> + </screen> + </example> + </para> + + <note> + <simpara> + В PHP4 было необходимо использовать ссылку при создании callback-функции для того, + чтобы она указывала на реальный объект, а не на его копию. + За подробностями обращайтесь к разделу + <link linkend="language.references">Объяснение ссылок</link>. + </simpara> + </note> + + &note.func-callback-exceptions; + + </sect2> + + <sect2 xml:id="language.types.void"> + <title>void</title> + + <para> + <literal>void</literal> в качестве типа результата означает, что возвращенное + значение бесполезно. <literal>void</literal> в списке параметров означает, что + функция не принимает параметров. + </para> + + </sect2> + + <sect2 xml:id="language.types.dotdotdot"> + <title>...</title> + + <para> + <parameter>$...</parameter> в прототипах функции означает + <literal>and so on</literal> (и так далее). Это имя переменной используется когда + функция может принимать бесконечное количество параметров. + </para> + + </sect2> +</sect1> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->

« previous php.doc.ru (#1107) next »