1
0
mirror of https://github.com/php/doc-ja.git synced 2026-03-24 07:02:08 +01:00
Files
archived-doc-ja/language/types/boolean.xml
2025-10-13 18:18:06 +09:00

181 lines
4.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f90b26b377a61c76c0f64028e47553e550411d08 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka,mumumu -->
<sect1 xml:id="language.types.boolean">
<title>論理型 (boolean) </title>
<simpara>
<type>bool</type> 型は、ふたつの値だけを持ち、真偽の値を表します。
この値は、&true; または &false; のどちらかになります。
</simpara>
<sect2 xml:id="language.types.boolean.syntax">
<title>構文</title>
<para>
bool リテラルを指定するには、定数 &true;
または &false; を指定してください。
両方とも大文字小文字を区別しません。
</para>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$foo = True; // 値TRUEを$fooに代入する
?>
]]>
</programlisting>
</informalexample>
<para>
通常、<type>bool</type> 型の値を返す<link
linkend="language.operators">演算子</link>を使用してから、
<link linkend="language.control-structures">制御構造</link>にその結果を渡します。
</para>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$action = "show_version";
$show_separators = true;
// == は、boolean型を返す演算子
if ($action == "show_version") {
echo "バージョンは1.23です。";
}
// これは冗長
if ($show_separators == TRUE) {
echo "<hr>\n";
}
// 上の例は次のように簡単に書くことができます。
if ($show_separators) {
echo "<hr>\n";
}
?>
]]>
</programlisting>
</informalexample>
</sect2>
<sect2 xml:id="language.types.boolean.casting">
<title>boolean への変換</title>
<simpara>
<type>bool</type> に明示的に変換を行うには、キャスト
<literal>(bool)</literal> を使用します。
論理型が必要な場合には、値は自動的に <type>bool</type>
型に変換されるので、一般的にはキャストは不要です。
詳細な情報は
<link linkend="language.types.type-juggling">型の相互変換</link>
のページを参照ください。
</simpara>
<para>
<type>bool</type> に変換する場合、次の値は &false; とみなされます。
</para>
<itemizedlist>
<listitem>
<simpara>
<link linkend="language.types.boolean">boolean</link>
&false;
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="language.types.integer">integer</link>
<literal>0</literal> (ゼロ)
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="language.types.float">float</link>
<literal>0.0</literal> および <literal>-0.0</literal> (ゼロ)
</simpara>
</listitem>
<listitem>
<simpara>
空の<link linkend="language.types.string">文字列</link> <literal>""</literal>
および<link linkend="language.types.string">文字列</link>
<literal>"0"</literal>
</simpara>
</listitem>
<listitem>
<simpara>
要素の数がゼロである <link linkend="language.types.array">配列</link>
</simpara>
</listitem>
<listitem>
<simpara>
unit 型 <link linkend="language.types.null">NULL</link>
(値がセットされていない変数を含む)
</simpara>
</listitem>
<listitem>
<simpara>
bool 型へキャストするように動作がオーバーロードされた内部オブジェクト。
例: 属性がない空要素から作成された <link linkend="ref.simplexml">SimpleXML</link>
オブジェクト。
</simpara>
</listitem>
</itemizedlist>
<para>
その他の値は全て &true; とみなされます。
(<link linkend="language.types.resource">resource</link>
および <constant>NAN</constant> を含みます)
</para>
<warning>
<simpara>
<literal>-1</literal> は、他のゼロでない数と同様に (正負によらず)
&true; とみなされます。
</simpara>
</warning>
<example>
<title>Boolean にキャストする</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump((bool) ""); // bool(false)
var_dump((bool) "0"); // bool(false)
var_dump((bool) 1); // bool(true)
var_dump((bool) -2); // bool(true)
var_dump((bool) "foo"); // bool(true)
var_dump((bool) 2.3e5); // bool(true)
var_dump((bool) array(12)); // bool(true)
var_dump((bool) array()); // bool(false)
var_dump((bool) "false"); // bool(true)
?>
]]>
</programlisting>
</example>
</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
-->