svn: /phpdoc/ru/trunk/reference/classobj/functions/ get-class.xml

From: Date: Mon, 07 Feb 2011 11:02:11 +0000
Subject: svn: /phpdoc/ru/trunk/reference/classobj/functions/ get-class.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1368@lists.php.net to get a copy of this message
shein Mon, 07 Feb 2011 11:02:11 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308097 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/classobj/functions/get-class.xml Modified: phpdoc/ru/trunk/reference/classobj/functions/get-class.xml =================================================================== --- phpdoc/ru/trunk/reference/classobj/functions/get-class.xml 2011-02-07 10:54:45 UTC (rev 308096) +++ phpdoc/ru/trunk/reference/classobj/functions/get-class.xml 2011-02-07 11:02:11 UTC (rev 308097) @@ -1,45 +1,109 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: 302261 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/classobj.xml, last change in rev 1.4 --> - <refentry xml:id="function.get-class" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>get_class</refname> - <refpurpose>Возвращает имя класса к которому принадлежит объект</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>get_class</methodname> - <methodparam><type>object</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - Функция возвращает имя класса экземпляром которого является - объект <parameter>obj</parameter>. Если <parameter>obj</parameter> не является - объектом, функция вернет &false; - </para> - <note> - <simpara> - Внутренние классы PHP, объявленные в расширениях возвращаются в - оригинальном регистре. В PHP 4, функция <function>get_class</function> возвращает - имя класса в нижнем регистре, однако в PHP 5 имя также возвращается в - оригинальном регистре, аналогично классам расширений. - </simpara> - </note> - <para> - <example> - <title>Использование <function>get_class</function></title> - <programlisting role="php"> +<refentry xml:id="function.get-class" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>get_class</refname> + <refpurpose>Возвращает имя класса, к которому принадлежит объект</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>get_class</methodname> + <methodparam choice="opt"><type>object</type><parameter>object</parameter><initializer>&null;</initializer></methodparam> + </methodsynopsis> + <para> + Возвращает имя класса, экземпляром которого является + объект <parameter>object</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + Тестируемый объект. Внутри класса этот параметр может быть опущен. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Возвращает имя класса, к которому принадлежит экземпляр <parameter>object</parameter>. + Возвращает &false;, если <parameter>object</parameter> не является + объектом. + </para> + <para> + Если параметр <parameter>object</parameter> опущен внутри класса, + будет возвращено имя этого класса. + </para> + </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <para> + Если <function>get_class</function> будет вызвана с чем-то другим, + не являющимся объектом, будет вызвана ошибка уровня + <constant>E_WARNING</constant>. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Начиная с версии 5.3.0</entry> + <entry> + &null; стал значением по умолчанию для параметра <parameter>object</parameter>, + поэтому передача &null; в <parameter>object</parameter> теперь имеет + тот же самый эффект, как и отсутствие какой-либо передачи + вообще. + </entry> + </row> + <row> + <entry>Начиная с версии 5.0.0</entry> + <entry> + Имя класса теперь возвращается в оригинальной записи. + </entry> + </row> + <row> + <entry>Начиная с версии 5.0.0</entry> + <entry> + Параметр <parameter>object</parameter> стал необязателен + при вызове из метода объекта. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Использование <function>get_class</function></title> + <programlisting role="php"> <![CDATA[ <?php class foo { - function foo() + function name() { - // имплементация чего-либо - } - - function name() - { echo "My name is " , get_class($this) , "\n"; } } @@ -55,26 +119,60 @@ ?> ]]> - </programlisting> - <para> - выведет: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Its name is foo My name is foo ]]> - </screen> - </example> - </para> - <para> - См. также <function>get_parent_class</function>, - <function>gettype</function> и - <function>is_subclass_of</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + <example> + <title>Использование <function>get_class</function> в родительском классе</title> + <programlisting role="php"> +<![CDATA[ +<?php +abstract class bar { + public function __construct() + { + var_dump(get_class($this)); + var_dump(get_class()); + } +} + +class foo extends bar { +} + +new foo; + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +string(3) "foo" +string(3) "bar" +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_called_class</function></member> + <member><function>get_parent_class</function></member> + <member><function>gettype</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -86,7 +184,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

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