svn: /phpdoc/ja/trunk/reference/misc/functions/ sapi-windows-cp-conv.xml sapi-windows-cp-get.xml sapi-windows-cp-is-utf8.xml sapi-windows-cp-set.xml sapi-windows-vt100-support.xml
[email protected] (Yoshinari Takaoka)
| Newsgroups | php.doc.ja |
|---|---|
| Message-ID | <[email protected]> |
mumumu Sat, 08 Feb 2020 00:55:28 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=349167
Log:
added translations of sapi-windows-* function docs.
Changed paths:
A phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-conv.xml
A phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-get.xml
A phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-is-utf8.xml
A phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-set.xml
A phpdoc/ja/trunk/reference/misc/functions/sapi-windows-vt100-support.xml
svn-diffs-349167.txt
(text/x-diff, 18.3 KB)
Added: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-conv.xml
===================================================================
--- phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-conv.xml (rev 0)
+++ phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-conv.xml 2020-02-08 00:55:28 UTC (rev 349167)
@@ -0,0 +1,103 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 344354 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="function.sapi-windows-cp-conv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>sapi_windows_cp_conv</refname>
+ <refpurpose>文字列のコードページを別のものに変換する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description"><!-- {{{ -->
+ &reftitle.description;
+ <methodsynopsis role="procedural">
+ <type>string</type><methodname>sapi_windows_cp_conv</methodname>
+ <methodparam><type>int|string</type><parameter>in_codepage</parameter></methodparam>
+ <methodparam><type>int|string</type><parameter>out_codepage</parameter></methodparam>
+ <methodparam><type>string</type><parameter>subject</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 文字列のコードページを別のものに変換します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="parameters"><!-- {{{ -->
+ &reftitle.parameters;
+ <variablelist>
+ <varlistentry>
+ <term><parameter>in_codepage</parameter></term>
+ <listitem>
+ <para>
+ <parameter>subject</parameter> 文字列のコードページ。
+ コードページの名前、または識別子を指定します。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>out_codepage</parameter></term>
+ <listitem>
+ <para>
+ <parameter>subject</parameter> を文字列が変換されるコードページ。
+ コードページの名前、または識別子を指定します。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>subject</parameter></term>
+ <listitem>
+ <para>
+ 変換する文字列。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+ &reftitle.returnvalues;
+ <para>
+ <parameter>out_codepage</parameter> に変換された <parameter>subject</parameter> 文字列。
+ 失敗した場合は &null; を返します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="errors"><!-- {{{ -->
+ &reftitle.errors;
+ <para>
+ この関数は、不正なコードページが与えられたり、
+ <parameter>subject</parameter> 文字列が
+ <parameter>in_codepage</parameter> でなかった場合は、
+ E_WARNINGレベルの警告を発生させます。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="seealso"><!-- {{{ -->
+ &reftitle.seealso;
+ <simplelist>
+ <member><function>sapi_windows_cp_get</function></member>
+ <member><function>iconv</function></member>
+ </simplelist>
+ </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
+-->
Property changes on: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-conv.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-get.xml
===================================================================
--- phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-get.xml (rev 0)
+++ phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-get.xml 2020-02-08 00:55:28 UTC (rev 349167)
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 344354 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="function.sapi-windows-cp-get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>sapi_windows_cp_get</refname>
+ <refpurpose>現在のプロセスのコードページを取得する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description"><!-- {{{ -->
+ &reftitle.description;
+ <methodsynopsis role="procedural">
+ <type>int</type><methodname>sapi_windows_cp_get</methodname>
+ <methodparam><type>string</type><parameter>kind</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 現在のプロセスのコードページの識別子を取得します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="parameters"><!-- {{{ -->
+ &reftitle.parameters;
+ <variablelist>
+ <varlistentry>
+ <term><parameter>kind</parameter></term>
+ <listitem>
+ <para>
+ コードページの種類: <literal>'ansi'</literal> または <literal>'oem'</literal>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+ &reftitle.returnvalues;
+ <para>
+ コードページの識別子を返します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="seealso"><!-- {{{ -->
+ &reftitle.seealso;
+ <simplelist>
+ <member><function>sapi_windows_cp_set</function></member>
+ </simplelist>
+ </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
+-->
Property changes on: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-get.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-is-utf8.xml
===================================================================
--- phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-is-utf8.xml (rev 0)
+++ phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-is-utf8.xml 2020-02-08 00:55:28 UTC (rev 349167)
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 344354 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="function.sapi-windows-cp-is-utf8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>sapi_windows_cp_is_utf8</refname>
+ <refpurpose>コードページがUTF-8と互換性があるかを返す</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description"><!-- {{{ -->
+ &reftitle.description;
+ <methodsynopsis role="procedural">
+ <type>bool</type><methodname>sapi_windows_cp_is_utf8</methodname>
+ <void />
+ </methodsynopsis>
+ <para>
+ 現在のプロセスのコードページが UTF-8 と互換性があるかを返します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="parameters"><!-- {{{ -->
+ &reftitle.parameters;
+ &no.function.parameters;
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+ &reftitle.returnvalues;
+ <para>
+ 現在のプロセスのコードページが UTF-8 と互換性があるかを返します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="seealso"><!-- {{{ -->
+ &reftitle.seealso;
+ <simplelist>
+ <member><function>sapi_windows_cp_get</function></member>
+ </simplelist>
+ </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
+-->
Property changes on: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-is-utf8.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-set.xml
===================================================================
--- phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-set.xml (rev 0)
+++ phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-set.xml 2020-02-08 00:55:28 UTC (rev 349167)
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 344354 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="function.sapi-windows-cp-set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>sapi_windows_cp_set</refname>
+ <refpurpose>現在のプロセスのコードページを設定する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description"><!-- {{{ -->
+ &reftitle.description;
+ <methodsynopsis role="procedural">
+ <type>bool</type><methodname>sapi_windows_cp_set</methodname>
+ <methodparam><type>int</type><parameter>cp</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 現在のプロセスのコードページを設定します。
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="parameters"><!-- {{{ -->
+ &reftitle.parameters;
+ <variablelist>
+ <varlistentry>
+ <term><parameter>cp</parameter></term>
+ <listitem>
+ <para>
+ コードページの識別子。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="seealso"><!-- {{{ -->
+ &reftitle.seealso;
+ <simplelist>
+ <member><function>sapi_windows_cp_get</function></member>
+ </simplelist>
+ </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
+-->
Property changes on: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-cp-set.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-vt100-support.xml
===================================================================
--- phpdoc/ja/trunk/reference/misc/functions/sapi-windows-vt100-support.xml (rev 0)
+++ phpdoc/ja/trunk/reference/misc/functions/sapi-windows-vt100-support.xml 2020-02-08 00:55:28 UTC (rev 349167)
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 346833 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="function.sapi-windows-vt100-support" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>sapi_windows_vt100_support</refname>
+ <refpurpose>Windows コンソールの出力バッファに関連付けられたストリームのVT100サポート状況を取得/設定する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description"><!-- {{{ -->
+ &reftitle.description;
+ <methodsynopsis role="procedural">
+ <type>bool</type><methodname>sapi_windows_vt100_support</methodname>
+ <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>enable</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <parameter>enable</parameter> が省略されると、
+ この関数は <parameter>stream</parameter> の VT100 制御コードが有効になっている場合に &true; を返します。
+ 無効になっている場合 &false; を返します。
+ </para>
+ <para>
+ <parameter>enable</parameter> が指定されると、
+ この関数は <parameter>stream</parameter> の VT100 の機能を 有効/無効 にしようとします。
+ VT100 の機能が無事有効(または無効)にできた場合、この関数は &true; を返します。
+ 失敗した場合 &false; を返します。
+ </para>
+ <para>
+ 起動時に、PHP は <constant>STDOUT</constant>/<constant>STDERR</constant> の VT100 の機能を有効にしようとします。これらのストリームがファイルにリダイレクトされると、VT100 の機能は有効にならないかもしれません。
+ </para>
+ <para>
+ VT100 のサポートが有効な場合、VT100 のターミナルで有効な制御シーケンスが使えます。
+ これによって、ターミナルの出力を変更できます。Windows では、
+ これらの制御シーケンスは Console Virtual Terminal Sequence と呼ばれています。
+ </para>
+ <warning>
+ <simpara>
+ この関数は、Windows 10 API で実装されている
+ <constant>ENABLE_VIRTUAL_TERMINAL_PROCESSING</constant> フラグを使います。
+ よって、古いWindowsバージョンでは VT100の機能は有効にならないかもしれません。
+ </simpara>
+ </warning>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="parameters"><!-- {{{ -->
+ &reftitle.parameters;
+ <variablelist>
+ <varlistentry>
+ <term><parameter>stream</parameter></term>
+ <listitem>
+ <para>
+ この関数で操作するストリーム
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>enable</parameter></term>
+ <listitem>
+ <para>
+ この値が指定されると、(&true; の場合) VT100の機能が有効になり、
+ (&false; の場合) 無効になります。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+ &reftitle.returnvalues;
+ <para>
+ <parameter>enable</parameter> が省略されると、
+ VT100 の機能が有効になっている場合に &true; を返します。
+ 無効になっている場合 &false; を返します。
+ </para>
+ <para>
+ <parameter>enable</parameter> が指定されると、&return.success;
+ </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="examples"><!-- {{{ -->
+ &reftitle.examples;
+ <example>
+ <title><function>sapi_windows_vt100_support</function> でデフォルトの状態を出力する</title>
+ <para>
+ デフォルトでは、
+ <constant>STDOUT</constant> / <constant>STDERR</constant> で VT100 の機能が有効になっています。
+ </para>
+ <programlisting role="sh">
+ php -r "var_export(sapi_windows_vt100_support(STDOUT));echo ' ';var_export(sapi_windows_vt100_support(STDERR));"
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+true true
+]]>
+ </screen>
+ <para>
+ ストリームがリダイレクトされた場合、
+ VT100 の機能は有効になりません。
+ </para>
+ <programlisting role="sh">
+ php -r "var_export(sapi_windows_vt100_support(STDOUT));echo ' ';var_export(sapi_windows_vt100_support(STDERR));" 2>NUL
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+ true false
+ </screen>
+ </example>
+ <example>
+ <title><function>sapi_windows_vt100_support</function> で状態を変更する</title>
+ <para>
+ ストリームがリダイレクトされた場合、
+ <constant>STDOUT</constant> や <constant>STDERR</constant> のVT100の機能は有効にできません。
+ </para>
+ <programlisting role="sh">
+ php -r "var_export(sapi_windows_vt100_support(STDOUT, true));echo ' ';var_export(sapi_windows_vt100_support(STDERR, true));" 2>NUL
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+true false
+]]>
+ </screen>
+ </example>
+ <example>
+ <title>VT100 のサポートを有効にする例</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$out = fopen('php://stdout','w');
+fwrite($out, 'Just forgot a lettr.');
+// カーソルを2文字分左に移動
+fwrite($out, "\033[2D");
+// 空白をひとつ分挿入し、既存のテキストを右に移動させる -> Just forgot a lett r.
+fwrite($out, "\033[1@");
+fwrite($out, 'e');
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Just forgot a letter.
+]]>
+ </screen>
+ </example>
+ </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
+-->
Property changes on: phpdoc/ja/trunk/reference/misc/functions/sapi-windows-vt100-support.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property