Skip to content

PHP 8.4 で追加された関数の新規翻訳 (pcntl, intl, pgsql) #398

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
KentarouTakeda merged 1 commit into from
Jun 13, 2026
+976 −0
Merged

PHP 8.4 で追加された関数の新規翻訳 (pcntl, intl, pgsql) #398

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
118 changes: 118 additions & 0 deletions reference/intl/dateformatter/parsetocalendar.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 20687bf9c58232244e41272d118b98ef4af16a69 Maintainer: KentarouTakeda Status: ready -->
<refentry xml:id="intldateformatter.parsetocalendar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>IntlDateFormatter::parseToCalendar</refname>
<refpurpose>文字列をパースしてタイムスタンプにし、使用中のカレンダーを更新する</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="IntlDateFormatter">
<modifier>public</modifier> <type class="union"><type>int</type><type>float</type><type>false</type></type><methodname>IntlDateFormatter::parseToCalendar</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter role="reference">offset</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<simpara>
<parameter>string</parameter> を時間に変換します。<parameter>offset</parameter>
からパースを開始し、入力値を可能な限り使用します。
</simpara>
<simpara>
このメソッドは <methodname>IntlDateFormatter::parse</methodname>
と同様に動作しますが、パースした <parameter>string</parameter>
に含まれるタイムゾーン情報に応じて、フォーマッターのタイムゾーンが更新される点が異なります。
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<simpara>
時間に変換する文字列。
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<simpara>
<parameter>string</parameter> のパースを開始する位置 (ゼロから数えます)。
<parameter>string</parameter> をすべて消費するまでにエラーが発生しなかった場合、
<parameter>offset</parameter> は -1 となります。それ以外の場合は、
パースが終了した (そしてエラーが発生した) 位置となります。
パースが失敗した場合、この変数にはその終了位置が格納されます。
<parameter>offset</parameter> &gt; <code>strlen($string)</code> の場合、パースは即時に失敗します。
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
タイムスタンプとしてパースされた値を返します。
パースできなかった場合は &false; を返します。
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title><methodname>IntlDateFormatter::parseToCalendar</methodname> の例</title>
<programlisting role="php">
<![CDATA[
<?php
$fmt = new IntlDateFormatter(
'en_US',
IntlDateFormatter::FULL,
IntlDateFormatter::FULL,
'America/Los_Angeles',
IntlDateFormatter::GREGORIAN
);
echo $fmt->parseToCalendar('Wednesday, December 20, 1989 at 4:00:00 PM Pacific Standard Time');
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
630201600
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>IntlDateFormatter::parse</methodname></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
<member><methodname>IntlDateFormatter::getErrorCode</methodname></member>
<member><methodname>IntlDateFormatter::getErrorMessage</methodname></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
-->
124 changes: 124 additions & 0 deletions reference/intl/spoofchecker/setallowedchars.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 20687bf9c58232244e41272d118b98ef4af16a69 Maintainer: KentarouTakeda Status: ready -->
<refentry xml:id="spoofchecker.setallowedchars" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Spoofchecker::setAllowedChars</refname>
<refpurpose>チェック時に許可する文字集合を設定する</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="Spoofchecker">
<modifier>public</modifier> <type>void</type><methodname>Spoofchecker::setAllowedChars</methodname>
<methodparam><type>string</type><parameter>pattern</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>patternOptions</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<simpara>
これ以降のチェックで許容される文字を、
<parameter>pattern</parameter> で記述された集合に制限します。
この集合に含まれない文字が存在すると、
<methodname>Spoofchecker::isSuspicious</methodname> はそれを疑わしいものとして報告します。
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>pattern</parameter></term>
<listitem>
<simpara>
<literal>UnicodeSet</literal> パターン、
すなわち正規表現スタイルの文字クラスとして記述された文字集合。
<literal>[</literal> で始まり <literal>]</literal> で終わる必要があります。
たとえば <literal>[a-z0-9]</literal> のようにします。
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>patternOptions</parameter></term>
<listitem>
<simpara>
<parameter>pattern</parameter> をどのように解釈するかを制御するビットマスク。
<literal>0</literal> にするか、
<constant>Spoofchecker::IGNORE_SPACE</constant> を単独で指定するか、
あるいはそれと <constant>Spoofchecker::CASE_INSENSITIVE</constant>、
<constant>Spoofchecker::ADD_CASE_MAPPINGS</constant>、
<constant>Spoofchecker::SIMPLE_CASE_INSENSITIVE</constant>
のいずれかひとつだけを組み合わせて指定しなければなりません。
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
値を返しません。
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
<parameter>pattern</parameter> が有効な文字集合のパターンでない場合や、
<parameter>patternOptions</parameter> がオプションの有効な組み合わせでない場合に、
<exceptionname>ValueError</exceptionname> をスローします。
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title><methodname>Spoofchecker::setAllowedChars</methodname> の例</title>
<programlisting role="php">
<![CDATA[
<?php
$checker = new Spoofchecker();
$checker->setAllowedChars('[a-z0-9]');

var_dump($checker->isSuspicious('hello'));
var_dump($checker->isSuspicious('héllo'));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(false)
bool(true)
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>Spoofchecker::setAllowedLocales</methodname></member>
<member><methodname>Spoofchecker::isSuspicious</methodname></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
-->
80 changes: 80 additions & 0 deletions reference/pcntl/functions/pcntl-forkx.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: acb474ea92ab6226eaf419a85de05f68c6715a9f Maintainer: KentarouTakeda Status: ready -->
<refentry xml:id="function.pcntl-forkx" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_forkx</refname>
<refpurpose>forkx(2) を使って子プロセスを生成する</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>pcntl_forkx</methodname>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>pcntl_forkx</function> 関数は、
illumos および Solaris システムで利用可能な
<literal>forkx(2)</literal> システムコールを使って子プロセスを生成します。
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<simpara>
<parameter>flags</parameter> パラメータは、フォークの動作を制御します。
デフォルトの動作にする場合は <literal>0</literal> を、
子プロセスの終了時に親プロセスへ <constant>SIGCHLD</constant>
シグナルが送信されるのを防ぐ場合は
<constant>FORK_NOSIGCHLD</constant> を渡します。
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
成功時に、子プロセスの PID が親プロセスの実行スレッドに返され、
子プロセスの実行スレッドには <literal>0</literal> が返されます。
失敗した場合、親プロセスのコンテキストに <literal>-1</literal> が返され、
子プロセスは生成されずに、PHP のエラーが発生します。
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_fork</function></member>
<member><function>pcntl_rfork</function></member>
<member><function>pcntl_waitpid</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
-->
64 changes: 64 additions & 0 deletions reference/pcntl/functions/pcntl-getcpu.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: acb474ea92ab6226eaf419a85de05f68c6715a9f Maintainer: KentarouTakeda Status: ready -->
<refentry xml:id="function.pcntl-getcpu" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_getcpu</refname>
<refpurpose>呼び出し元のプロセスが最後に実行された CPU の番号を取得する</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>pcntl_getcpu</methodname>
<void/>
</methodsynopsis>
<simpara>
<function>pcntl_getcpu</function> は、
呼び出し元のプロセスが最後に実行された CPU の番号を返します。
この関数は、Linux で利用可能な
<literal>sched_getcpu(3)</literal> システムコールを使います。
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
CPU の番号を &integer; として返します。
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_getcpuaffinity</function></member>
<member><function>pcntl_setcpuaffinity</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
-->
Loading
Loading