Skip to content

Commit 448b006

Browse files
lacatoirelacatoire
committed
[Sync EN] Document IntlDateFormatter::parseToCalendar and Spoofchecker::setAllowedChars (PHP 8.4) (#5283)
1 parent 08e5b7a commit 448b006

2 files changed

Lines changed: 235 additions & 0 deletions

File tree

‎reference/intl/dateformatter/parsetocalendar.xml‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 20687bf9c58232244e41272d118b98ef4af16a69 Maintainer: lacatoire Status: ready -->
3+
<refentry xml:id="intldateformatter.parsetocalendar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refnamediv>
5+
<refname>IntlDateFormatter::parseToCalendar</refname>
6+
<refpurpose>Analysiert eine Zeichenkette zu einem Zeitstempel und aktualisiert einen offenen Kalender</refpurpose>
7+
</refnamediv>
8+
<refsect1 role="description">
9+
&reftitle.description;
10+
<methodsynopsis role="IntlDateFormatter">
11+
<modifier>public</modifier> <type class="union"><type>int</type><type>float</type><type>false</type></type><methodname>IntlDateFormatter::parseToCalendar</methodname>
12+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
13+
<methodparam choice="opt"><type>int</type><parameter role="reference">offset</parameter><initializer>&null;</initializer></methodparam>
14+
</methodsynopsis>
15+
<simpara>
16+
Wandelt <parameter>string</parameter> in einen inkrementellen Zeitwert um, beginnend bei
17+
<parameter>offset</parameter>, und verbraucht dabei so viel von der Eingabe wie möglich.
18+
</simpara>
19+
<simpara>
20+
Diese Methode verhält sich wie <methodname>IntlDateFormatter::parse</methodname>, mit dem
21+
Unterschied, dass die Zeitzone des Formatierers entsprechend den Zeitzonen-Informationen
22+
aktualisiert wird, die in der analysierten Zeichenkette <parameter>string</parameter> enthalten sind.
23+
</simpara>
24+
</refsect1>
25+
26+
<refsect1 role="parameters">
27+
&reftitle.parameters;
28+
<variablelist>
29+
<varlistentry>
30+
<term><parameter>string</parameter></term>
31+
<listitem>
32+
<simpara>
33+
Die in eine Zeit umzuwandelnde Zeichenkette.
34+
</simpara>
35+
</listitem>
36+
</varlistentry>
37+
<varlistentry>
38+
<term><parameter>offset</parameter></term>
39+
<listitem>
40+
<simpara>
41+
Die Position in <parameter>string</parameter>, an der die Analyse beginnen soll (nullbasiert).
42+
Tritt kein Fehler auf, bevor <parameter>string</parameter> vollständig verbraucht wurde,
43+
enthält <parameter>offset</parameter> den Wert -1, andernfalls die Position, an der die
44+
Analyse endete (und der Fehler auftrat).
45+
Diese Variable enthält die Endposition, wenn die Analyse fehlschlägt.
46+
Wenn <parameter>offset</parameter> &gt; <code>strlen($string)</code> ist, schlägt die Analyse sofort fehl.
47+
</simpara>
48+
</listitem>
49+
</varlistentry>
50+
</variablelist>
51+
</refsect1>
52+
53+
<refsect1 role="returnvalues">
54+
&reftitle.returnvalues;
55+
<simpara>
56+
Den Zeitstempel des analysierten Werts oder &false;, wenn der Wert nicht analysiert werden kann.
57+
</simpara>
58+
</refsect1>
59+
60+
<refsect1 role="examples">
61+
&reftitle.examples;
62+
<example>
63+
<title>Beispiel für <methodname>IntlDateFormatter::parseToCalendar</methodname></title>
64+
<programlisting role="php">
65+
<![CDATA[
66+
<?php
67+
$fmt = new IntlDateFormatter(
68+
'en_US',
69+
IntlDateFormatter::FULL,
70+
IntlDateFormatter::FULL,
71+
'America/Los_Angeles',
72+
IntlDateFormatter::GREGORIAN
73+
);
74+
echo $fmt->parseToCalendar('Wednesday, December 20, 1989 at 4:00:00 PM Pacific Standard Time');
75+
?>
76+
]]>
77+
</programlisting>
78+
&example.outputs;
79+
<screen>
80+
<![CDATA[
81+
630201600
82+
]]>
83+
</screen>
84+
</example>
85+
</refsect1>
86+
87+
<refsect1 role="seealso">
88+
&reftitle.seealso;
89+
<simplelist>
90+
<member><methodname>IntlDateFormatter::parse</methodname></member>
91+
<member><methodname>IntlDateFormatter::format</methodname></member>
92+
<member><methodname>IntlDateFormatter::getErrorCode</methodname></member>
93+
<member><methodname>IntlDateFormatter::getErrorMessage</methodname></member>
94+
</simplelist>
95+
</refsect1>
96+
</refentry>
97+
<!-- Keep this comment at the end of the file
98+
Local variables:
99+
mode: sgml
100+
sgml-omittag:t
101+
sgml-shorttag:t
102+
sgml-minimize-attributes:nil
103+
sgml-always-quote-attributes:t
104+
sgml-indent-step:1
105+
sgml-indent-data:t
106+
indent-tabs-mode:nil
107+
sgml-parent-document:nil
108+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
109+
sgml-exposed-tags:nil
110+
sgml-local-catalogs:nil
111+
sgml-local-ecat-files:nil
112+
End:
113+
vim600: syn=xml fen fdm=syntax fdl=2 si
114+
vim: et tw=78 syn=sgml
115+
vi: ts=1 sw=1
116+
-->

‎reference/intl/spoofchecker/setallowedchars.xml‎

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 20687bf9c58232244e41272d118b98ef4af16a69 Maintainer: lacatoire Status: ready -->
3+
<refentry xml:id="spoofchecker.setallowedchars" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refnamediv>
5+
<refname>Spoofchecker::setAllowedChars</refname>
6+
<refpurpose>Legt die Menge der bei Prüfungen erlaubten Zeichen fest</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis role="Spoofchecker">
12+
<modifier>public</modifier> <type>void</type><methodname>Spoofchecker::setAllowedChars</methodname>
13+
<methodparam><type>string</type><parameter>pattern</parameter></methodparam>
14+
<methodparam choice="opt"><type>int</type><parameter>patternOptions</parameter><initializer>0</initializer></methodparam>
15+
</methodsynopsis>
16+
<simpara>
17+
Beschränkt die Zeichen, die bei nachfolgenden Prüfungen als zulässig gelten, auf die
18+
durch <parameter>pattern</parameter> beschriebene Menge. Jedes Zeichen außerhalb dieser
19+
Menge führt dazu, dass <methodname>Spoofchecker::isSuspicious</methodname> ein Ergebnis meldet.
20+
</simpara>
21+
</refsect1>
22+
23+
<refsect1 role="parameters">
24+
&reftitle.parameters;
25+
<variablelist>
26+
<varlistentry>
27+
<term><parameter>pattern</parameter></term>
28+
<listitem>
29+
<simpara>
30+
Eine als <literal>UnicodeSet</literal>-Muster beschriebene Zeichenmenge, also eine
31+
Zeichenklasse im Stil eines regulären Ausdrucks. Sie muss mit <literal>[</literal>
32+
beginnen und mit <literal>]</literal> enden, zum Beispiel <literal>[a-z0-9]</literal>.
33+
</simpara>
34+
</listitem>
35+
</varlistentry>
36+
<varlistentry>
37+
<term><parameter>patternOptions</parameter></term>
38+
<listitem>
39+
<simpara>
40+
Eine Bitmaske, die steuert, wie <parameter>pattern</parameter> interpretiert wird. Sie muss
41+
<literal>0</literal> oder <constant>Spoofchecker::IGNORE_SPACE</constant> für sich allein
42+
oder kombiniert mit genau einer der Konstanten <constant>Spoofchecker::CASE_INSENSITIVE</constant>,
43+
<constant>Spoofchecker::ADD_CASE_MAPPINGS</constant> oder
44+
<constant>Spoofchecker::SIMPLE_CASE_INSENSITIVE</constant> sein.
45+
</simpara>
46+
</listitem>
47+
</varlistentry>
48+
</variablelist>
49+
</refsect1>
50+
51+
<refsect1 role="returnvalues">
52+
&reftitle.returnvalues;
53+
<simpara>
54+
&return.void;
55+
</simpara>
56+
</refsect1>
57+
58+
<refsect1 role="errors">
59+
&reftitle.errors;
60+
<simpara>
61+
Löst einen <exceptionname>ValueError</exceptionname> aus, wenn <parameter>pattern</parameter>
62+
kein gültiges Zeichenmengen-Muster ist oder wenn <parameter>patternOptions</parameter> keine
63+
gültige Kombination von Optionen ist.
64+
</simpara>
65+
</refsect1>
66+
67+
<refsect1 role="examples">
68+
&reftitle.examples;
69+
<example>
70+
<title>Beispiel für <methodname>Spoofchecker::setAllowedChars</methodname></title>
71+
<programlisting role="php">
72+
<![CDATA[
73+
<?php
74+
$checker = new Spoofchecker();
75+
$checker->setAllowedChars('[a-z0-9]');
76+
77+
var_dump($checker->isSuspicious('hello'));
78+
var_dump($checker->isSuspicious('héllo'));
79+
?>
80+
]]>
81+
</programlisting>
82+
&example.outputs;
83+
<screen>
84+
<![CDATA[
85+
bool(false)
86+
bool(true)
87+
]]>
88+
</screen>
89+
</example>
90+
</refsect1>
91+
92+
<refsect1 role="seealso">
93+
&reftitle.seealso;
94+
<simplelist>
95+
<member><methodname>Spoofchecker::setAllowedLocales</methodname></member>
96+
<member><methodname>Spoofchecker::isSuspicious</methodname></member>
97+
</simplelist>
98+
</refsect1>
99+
</refentry>
100+
<!-- Keep this comment at the end of the file
101+
Local variables:
102+
mode: sgml
103+
sgml-omittag:t
104+
sgml-shorttag:t
105+
sgml-minimize-attributes:nil
106+
sgml-always-quote-attributes:t
107+
sgml-indent-step:1
108+
sgml-indent-data:t
109+
indent-tabs-mode:nil
110+
sgml-parent-document:nil
111+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
112+
sgml-exposed-tags:nil
113+
sgml-local-catalogs:nil
114+
sgml-local-ecat-files:nil
115+
End:
116+
vim600: syn=xml fen fdm=syntax fdl=2 si
117+
vim: et tw=78 syn=sgml
118+
vi: ts=1 sw=1
119+
-->

0 commit comments

Comments
 (0)