get-debug-type.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0edc11c6c46753ef0b81d0060b925b4f58552996 Maintainer: Luffy Status: ready -->
<refentry xml:id="function.get-debug-type" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>get_debug_type</refname>
  <refpurpose>以适合调试的方式获取变量的类型名称</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>get_debug_type</methodname>
   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
  </methodsynopsis>
  <para>
   会返回 PHP 变量 <parameter>value</parameter> 的类型名称。
   该函数会将对象解析为其类名，资源解析为其资源类型名称，标量值解析为其常用名称，就像在类型声明中使用的那样。
  </para>
  <para>
   该函数与 <function>gettype</function> 的区别在于：它返回的类型名称更符合实际用法，而不是那些出于历史原因而存在的名称。
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>value</parameter></term>
     <listitem>
      <para>
       要检查类型的变量。
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
    返回的字符串可能有以下值：

     <informaltable>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>类型 + 状态</entry>
         <entry>返回值</entry>
         <entry>备注</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>null</entry>
         <entry>
          <literal>"null"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Booleans (true or false)</entry>
         <entry>
          <literal>"bool"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Integers</entry>
         <entry>
          <literal>"int"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Floats</entry>
         <entry>
          <literal>"float"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Strings</entry>
         <entry>
          <literal>"string"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Arrays</entry>
         <entry>
          <literal>"array"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Resources</entry>
         <entry>
          <literal>"resource (resourcename)"</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Resources (Closed)</entry>
         <entry>
          <literal>"resource (closed)"</literal>
         </entry>
         <entry>例如：使用 fclose 关闭后的文件流</entry>
        </row>
        <row>
         <entry>Objects from Named Classes</entry>
         <entry>
          类的全名，包括其命名空间，例如 <literal>Foo\Bar</literal>
         </entry>
         <entry>-</entry>
        </row>
        <row>
         <entry>Objects from Anonymous Classes</entry>
         <entry>
          <literal>"class@anonymous"</literal>
         </entry>
         <entry>
          匿名类是通过 $x = new class { ... } 语法创建的类
         </entry>
        </row>
       </tbody>
      </tgroup>
     </informaltable>
  </para>
 </refsect1>


 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>get_debug_type</function> 示例</title>
    <programlisting role="php">
<![CDATA[
<?php
echo get_debug_type(null) . PHP_EOL;
echo get_debug_type(true) . PHP_EOL;
echo get_debug_type(1) . PHP_EOL;
echo get_debug_type(0.1) . PHP_EOL;
echo get_debug_type("foo") . PHP_EOL;
echo get_debug_type([]) . PHP_EOL;

$fp = fopen(__FILE__, 'rb');
echo get_debug_type($fp) . PHP_EOL;

fclose($fp);
echo get_debug_type($fp) . PHP_EOL;

echo get_debug_type(new stdClass) . PHP_EOL;
echo get_debug_type(new class {}) . PHP_EOL;
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen>
<![CDATA[
null
bool
int
float
string
array
resource (stream)
resource (closed)
stdClass
class@anonymous
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>gettype</function></member>
    <member><function>get_class</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>
<!-- 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
-->