hirokawa Fri Jul 20 10:30:52 2001 EDT
Modified files:
/phpdoc/ja/functions pcre.xml
/phpdoc/ja/language basic-syntax.xml constants.xml
Log:
updated translation.
Index: phpdoc/ja/functions/pcre.xml
diff -u phpdoc/ja/functions/pcre.xml:1.24 phpdoc/ja/functions/pcre.xml:1.25
--- phpdoc/ja/functions/pcre.xml:1.24 Sat Jul 7 18:26:03 2001
+++ phpdoc/ja/functions/pcre.xml Fri Jul 20 10:30:48 2001
@@ -841,6 +841,16 @@
</simpara>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><emphasis>u</emphasis> (PCRE_UTF8)</term>
+ <listitem>
+ <simpara>
+
+この修正子は、Perl非互換なPCREの機能を有効にします。パターン
+
+文字列は、UTF-8エンコードされた文字列として処理されます。こ
+ の修正子は、PHP-4.0.7以降で使用可能です。
+ </simpara>
+ </listitem>
+ </varlistentry>
</variablelist>
</blockquote>
</para>
Index: phpdoc/ja/language/basic-syntax.xml
diff -u phpdoc/ja/language/basic-syntax.xml:1.3 phpdoc/ja/language/basic-syntax.xml:1.4
--- phpdoc/ja/language/basic-syntax.xml:1.3 Thu Dec 14 09:45:17 2000
+++ phpdoc/ja/language/basic-syntax.xml Fri Jul 20 10:30:50 2001
@@ -1,38 +1,88 @@
<chapter id="language.basic-syntax">
<title>基本的な構文</title>
+
+ <!--
+
+ NOTE: Last modified: 2001-05-16 13:00 GMT
+
+ the language part is currently under heavy revision. Please do not
+ not make any heavy (i.e. structural) modifications to this part
+ for a moment.
+
+ You'd also better not start any translation yet.
+
+ Comments are always welcome at [EMAIL PROTECTED]
+
+ Progress:
+
+ intro : DOESN'T EXIST - yet?
+ new chapter, with some introductionary remarks?
+ Will be discussed on the ML soon.
+ basic-syntax:
+ FINISHED
+ except maybe moving the 'advanced escaping'
+ to a better place?
+ TODO:
+ - nada
+ types : Being revised. Added all new types
+ Boolean and Integer are more or less finished.
+ The rest isn't.
+ TODO:
+ - why is $foo[bar] bad syntax?
+ - what's the difference between unset($bla) and
+ $bla = NULL; (it is different!)
+ - $obj->{expr} syntax
+ - (unset) cast?????
+ - $bla = unset <== should've been nuked, don't mention it
+ - $str{offset} syntax, rather than $str[offset]
+ - read notes and apply when any of them are useful
+ - remove notes which have been included here.
+ - ...
+ the rest: Not yet started with.
+ TODO:
+ - ?
+ oop : has been revised by Kristian, DONE.
+ -->
<sect1 id="language.basic-syntax.phpmode">
<title>HTML からの脱出</title>
<para>
- HTML から抜けて"PHP
コードモード"に入るには、以下の4種類の方法があ
- ります。
+
+PHPがファイル処理を開始する際、PHPが処理するテキストを単純に出力し
+
+ます。このため、あるHTMLファイルの拡張子を.phpに変更した場合でも、
+ 出力は同じとなります。
+ </para>
+
+ <para>
+
+PHPの命令をファイルの中に挿入したい場合、以下の手段のどれかにより
+
+「PHPモード」に入ることにより、PHPにそれを示す必要があります。
</para>
<para>
<example>
<title>HTMLからの脱出法</title>
<programlisting>
-1. <? echo ("この方法は最も簡単で、SGMLの処理命令です\n"); ?>
+1. <? echo ("この方法は最も簡単で、SGMLの処理命令です\n"); ?>
-2. <?php
echo("XHTMLまたはXMLドキュメントを処理したい場合は、この方法が良いでしょう\n");
?>
+2. <?php
+echo("XHTMLまたはXMLドキュメントを処理したい場合は、この方法が良いでしょう\n");
+ ?>
-3. <script language="php">
+3. <script language="php">
echo ("(FrontPageのような) いくつかのエディタ
は処理命令を好み
ません");
- </script>
+ </script>
-4. <% echo ("オプションでASP形式のタグを使用可能です"); %>
- <%= $variable; # これは、"<%echo .." のショートカットです。%>
+4. <% echo ("オプションでASP形式のタグを使用可能です"); %>
+ <%= $variable; # これは、"<%echo .."
+のショートカットです。%>
</programlisting>
</example>
</para>
<para>
-
最初の方法は、ショートタグが有効な場合にのみ利用可能です。
- ショートタグは、
+
+最初の方法は、短縮型のタグが有効な場合にのみ利用可能です。
+ 短縮型のタグは、PHPの設定ファイルに
<!-- <function>short_tags</function> 関数を使用するか、-->
- --enable-short-tags オプションを <command>configure</command> に
+ <link linkend="ini.short-open-tag">short_open_tag</link>を設定する
+ か--enable-short-tags オプションを <command>configure</command> に
指定して PHP
をコンパイルすることにより、有効にできます。
</para>
@@ -42,7 +92,7 @@
</para>
<para>
- 4番目の方法は、ASP型のタグが
+ 4番目の方法は、ASP型式のタグが
<link linkend="ini.asp-tags">asp_tags</link> の設定により有効となっ
ている場合にのみ使用可能です。
@@ -57,6 +107,35 @@
ブロックの閉じ括弧(右括弧)タグは、直後に改行がある場合、それを含ん
だものになります。
</para>
+
+ <para> <!-- TODO: find a better place for this para -->
+ PHP は、次のような構造を使用可能です。
+ <example><title>高度なエスケープ処理</title>
+ <programlisting role="php">
+<?php
+
+if ( boolean-expression )
+{
+ ?>
+<strong>This is true.</strong>
+ <?php
+}
+else
+{
+ ?>
+<strong>This is false.</strong>
+ <?php
+}
+ ?>
+ </programlisting>
+ </example>
+
+ このコードは期待通りに動作します。これは、PHPが?>
+および
+ <?phpの中のテキストを<function>echo</function>命令として処理す
+ るためです。
+ <!-- without the parsing if vars, that is (hopefully?) obvious -->
+ </para>
+
</sect1>
<sect1 id="language.basic-syntax.instruction-separation">
@@ -68,11 +147,11 @@
</simpara>
<para>
- 閉じるタグ (?>) も文の終わりの意味を有します。
- このため、以下の文は等価です。
+ 閉じるタグ (?>)
+も文の終わりの意味を有します。このため、以下の
+ 文は等価です。
<informalexample>
- <programlisting role="php">
+ <programlisting>
<?php
echo "This is a test";
?>
@@ -91,7 +170,7 @@
例えば、
<informalexample>
- <programlisting role="php">
+ <programlisting>
<?php
echo "This is a test"; // C++型の単一行用のコメント
/* 複数行用のコメント
@@ -105,10 +184,10 @@
<simpara>
"一行"コメントは、改行またはPHPコードのブロックの終わり
- のうち最初にくる方までです。
+ のうちどちらか最初にくる方までです。
</simpara>
<informalexample>
- <programlisting role="php">
+ <programlisting>
<h1>This is an <?php # echo "simple";?> example.</h1>
<p>The header above will say 'This is an example'.
</programlisting>
@@ -120,7 +199,7 @@
</simpara>
<informalexample>
- <programlisting role="php">
+ <programlisting>
<?php
/*
echo "This is a test"; /* このコメントが問題を生じます */
Index: phpdoc/ja/language/constants.xml
diff -u phpdoc/ja/language/constants.xml:1.6 phpdoc/ja/language/constants.xml:1.7
--- phpdoc/ja/language/constants.xml:1.6 Sat Jul 7 18:26:24 2001
+++ phpdoc/ja/language/constants.xml Fri Jul 20 10:30:51 2001
@@ -1,160 +1,250 @@
<chapter id="language.constants">
<title>定数</title>
-
+
<simpara>
- PHP
は、いくつかの定数を定義します。また、実行時に定数の定義を追加する
- 機構を提供します。
- 定数は変数と良く似ていますが、定数は<function>define</function>
-
関数を使って定義する必要があり、他の値に再定義することができないという
- 二つの違いがあります。
+
+定数は簡単な値のためのID(名前)です。この名前が示すように、定数の値
+ はスクリプト実行中に変更できません。(特別な定数
+ <constant>__FILE__</constant> および
+ <constant>__LINE__</constant> は例外です。)
+
+デフォルトで定数では大文字小文字を区別します。定数の表記は常に大文
+ 字です。
</simpara>
-
<para>
- あらかじめ定義された定数(常に使用可能)を以下に示します。
-
- <variablelist>
+
+定数の名前は、PHPのラベルと同じ規則に従います。有効な定数の名前は、
+
+文字またはアンダースコアで始まり、任意の数の文字、数字、アンダース
+
+コアが後に続きます。正規表現で示すと、次のようになります。
+ <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>
- <varlistentry>
- <term>__FILE__</term>
- <listitem>
- <simpara>
-
現在処理中のスクリプトファイルの名前。includeあるいはrequireにより
-
読みこまれたファイルで使用された場合、親ファイルではなく
- インクルードされたファイルとなります。
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>__LINE__</term>
- <listitem>
- <simpara>
- カレントのスクリプトファイルの現在処理中の行の番号。
- includeあるいはrequireされたファイルで使用された場合、
- includeされたファイルの中での位置となります。
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>PHP_VERSION</term>
- <listitem>
- <simpara>
- 現在使用中のPHPパーサのバージョンを表す文字列。
- 例:'3.0.8-dev'
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>PHP_OS</term>
- <listitem>
- <simpara>
- PHPパーサを実行中のオペレーティングシステムの名前。
- 値として考えられるものは次のようになります。
- "AIX", "Darwin" (MacOS), "Linux", "SunOS", "WIN32", "WINNT".
- 注意: 他の値もあり得ます。
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>&true;</term>
- <listitem>
- <simpara>
- 真。
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>&false;</term>
+ <!-- TODO: Example of valid & invalid constant names -->
+ </para>
+
+ <note>
+ <simpara>
+ 本節の目的においては、文字は a-z, A-Z, および127から255まで
+ (0x7f-0xff)のASCII文字を指します。
+ </simpara>
+ </note>
+ <simpara>
+ 定数のスコープはグローバルです。
+ </simpara>
+ <sect1 id="language.constants.syntax">
+ <title>構文</title>
+ <simpara>
+
+<function>define</function>関数を使用することにより、定数を定義す
+
+ることが可能です。定数が一度定義されると、変更または未定義とするこ
+ とはできません。
+ </simpara>
+ <simpara>
+ スカラーデータ(<type>boolean</type>, <type>integer</type>,
+ <type>double</type>, <type>string</type>) のみが定数の中に含むこと
+ が可能です。
+ </simpara>
+ <simpara>
+
+単に定数の名前を指定することにより、その値を得ることが可能です。
+ 変数とは異なり、その前に<literal>$</literal>は不要です。
+
+定数の名前を動的に得る必要がある場合、定数の値を読むために関数
+ <function>constant</function>を使用することも可能です。
+ 定義済の定数の一覧を得るには、
+ <function>get_defined_constants</function>を使用して下さい。
+ </simpara>
+ <note>
+ <simpara>
+ 定数と(グローバル)変数は、異なる名前空間にあります。
+ 例えば、&true; と <varname>$TRUE</varname>
+は違うものを意味します。
+ </simpara>
+ </note>
+ <simpara>
+
+未定義の定数を使用した場合、PHPはその定数自体の名前を使用したと仮
+ 定します。この際、<link
+ linkend="features.error-handling">notice</link> が発生します。
+ ある定数が設定されているかどうかを知るには、
+ <function>defined</function>巻数を使用して下さい。
+ </simpara>
+ <para>
+ 変数との違いは次のようになります。
+ <itemizedlist>
<listitem>
<simpara>
- 偽。
+ 定数は、前にドル記号(<literal>$</literal>)を要しません。
</simpara>
</listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_ERROR</term>
<listitem>
<simpara>
- 構文エラー以外の回復不能なエラーを定義します。
+
+定数は、定義することができ、変数のスコープ規則に関係なく、あら
+ ゆる場所からアクセス可能です。
</simpara>
</listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_WARNING</term>
<listitem>
<simpara>
-
何か誤りがあるが、それでも実行を継続する条件を定義します。
- スクリプト自体によりエラー処理を行うことが可能です。
- 例えば<function>ereg</function>における正規表現が不正であった
- 場合に発生します。
+
+定数は一度設定されると再定義または未定義とすることはできません。
</simpara>
</listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_PARSE</term>
<listitem>
<simpara>
-
スクリプトファイルの不正な構文によりパーサの処理が中断した
- 状態です。回復は不可能です。
+ 定数は、スカラー値としてのみ評価可能です。
</simpara>
</listitem>
- </varlistentry>
+ </itemizedlist>
+ </para>
- <varlistentry>
- <term>E_NOTICE</term>
- <listitem>
- <simpara>
-
エラーであるかにかかわらず何かが起きました。実行は継続されます。
-
例えば、引用符で括られていない文字列をハッシュインデックスとして
-
使用した場合や設定されていない変数にアクセスした場合。
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>E_ALL</term>
- <listitem>
- <simpara>
- 全ての定数E_*が含まれます。
- <function>error_reporting</function>で使用された場合、
-
PHPにより通知された全種類の全ての問題がリポートされます。
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- E_* 定数は、エラーレポートレベルを設定するために通常
- <function>error_reporting</function> 関数と共に使用されます。
- これら全ての定数については、
- <link linkend="features.error-handling">エラー処理</link>を参照下さい。
- </para>
- <para>
- <function>define</function>
関数により定数の定義を追加することができます。
- </para>
- <para>
- これらは定数であり、C
言語のマクロではないことに注意してください。
- 有効なスカラーデータのみが定数として表現可能です。
- <example>
- <title>定数の定義</title>
- <programlisting>
+ <para>
+ <example>
+ <title>定数の定義</title>
+ <programlisting>
<?php
define("CONSTANT", "Hello world.");
-echo CONSTANT; // "Hello world." を出力します。
+echo CONSTANT; // "Hello world."を出力
+echo Constant; // outputs "Constant" および通知を発生。
?>
- </programlisting>
- </example>
+ </programlisting>
+ </example>
+
+ </para>
- <example>
- <title>__FILE__ および __LINE__ の使用</title>
- <programlisting>
+ </sect1>
+
+ <sect1 id="language.constants.predefined">
+ <title>定義済の定数</title>
+ <para>
+
+あらかじめ定義された定数(常に使用可能)を以下に示します。
+
+ <variablelist>
+
+ <varlistentry>
+ <term>__FILE__ (大文字小文字区別せず)</term>
+ <listitem>
+ <simpara>
+
+現在処理中のスクリプトファイルの名前。includeまたはrequireによ
+
+り読みこまれたファイルで使用された場合、親ファイルの名前ではな
+ く読みこまれたファイルの名前となります。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>__LINE__ (大文字小文字区別せず)</term>
+ <listitem>
+ <simpara>
+
+カレントのスクリプトファイルでパース中の行の番号。includeまた
+
+はrequireされたファイルで使用された場合、includeされたファイル
+ の中での位置となります。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>PHP_VERSION</term>
+ <listitem>
+ <simpara>
+ 現在使用中のPHPパーサのバージョンを表す文字列。
+ 例:'4.0.7-dev'
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>PHP_OS</term>
+ <listitem>
+ <simpara>
+ PHPパーサを実行中のオペレーティングシステムの名前。
+ 値として考えられるものは次のようになります。
+ "AIX", "Darwin" (MacOS), "Linux", "SunOS", "WIN32", "WINNT"
+ 注意: 他の値もあり得ます。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>&true; (大文字小文字区別せず)</term>
+ <listitem>
+ <simpara>
+ 真値 (<type>boolean</type> 型参照)。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>&false; (大文字小文字区別せず)</term>
+ <listitem>
+ <simpara>
+ 偽値 (<type>boolean</type> 型参照)。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>&null; (大文字小文字区別せず)</term>
+ <listitem>
+ <simpara>
+ &null; 値 (<type>null</type> 型参照)
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_ERROR</term>
+ <listitem>
+ <simpara>
+ 構文エラー以外の回復不能なエラーを定義します。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_WARNING</term>
+ <listitem>
+ <simpara>
+
+何か誤りがあるが、それでも実行を継続する条件を定義します。
+ スクリプト自体によりエラー処理を行うことが可能です。
+ 例えば<function>ereg</function>における正規表現が不正であった
+ 場合に発生します。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_PARSE</term>
+ <listitem>
+ <simpara>
+
+スクリプトファイルの不正な構文によりパーサの処理が中断した
+ 状態です。回復は不可能です。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_NOTICE</term>
+ <listitem>
+ <simpara>
+
+エラーであるかにかかわらず何かが起きました。実行は継続されます。
+
+例えば、引用符で括られていない文字列をハッシュインデックスとして
+
+使用した場合や設定されていない変数にアクセスした場合。
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>E_ALL</term>
+ <listitem>
+ <simpara>
+ 全ての定数E_*が含まれます。
+ <function>error_reporting</function>で使用された場合、
+
+PHPにより通知された全種類の全ての問題がリポートされます。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ <para>
+ E_* 定数は、エラーレポートレベルを設定するために通常
+ <function>error_reporting</function> 関数と共に使用されます。
+ これら全ての定数については、
+ <link
+linkend="features.error-handling">エラー処理</link>を参照下さい。
+
+ <example>
+ <title>__FILE__ および __LINE__ の使用</title>
+ <programlisting>
<?php
function report_error($file, $line, $message) {
echo "An error occured in $file on line $line: $message.";
@@ -162,9 +252,10 @@
report_error(__FILE__,__LINE__, "Something went wrong!");
?>
- </programlisting>
- </example>
- </para>
+ </programlisting>
+ </example>
+ </para>
+ </sect1>
</chapter>
<!-- Keep this comment at the end of the file
