Skip to content

Commit 3f68493

Browse files
authored
Translate get_*_handler (#2175)
1 parent 9387c4d commit 3f68493

File tree

2 files changed

+246
-0
lines changed

2 files changed

+246
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 4a6671fe697ead5b27603b56face01a2c4e7ebe5 Maintainer: Fan2Shrek Status: ready -->
3+
<!-- Reviewed: yes -->
4+
<refentry xml:id="function.get-error-handler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>get_error_handler</refname>
7+
<refpurpose>Renvoie la fonction de gestion d'erreur définie par l'utilisateur</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type class="union"><type>callable</type><type>null</type></type><methodname>get_error_handler</methodname>
14+
<void/>
15+
</methodsynopsis>
16+
<simpara>
17+
Renvoie la fonction de gestion d'erreur définie par l'utilisateur, si une a été définie.
18+
</simpara>
19+
</refsect1>
20+
21+
<refsect1 role="parameters">
22+
&reftitle.parameters;
23+
&no.function.parameters;
24+
</refsect1>
25+
26+
<refsect1 role="returnvalues">
27+
&reftitle.returnvalues;
28+
<simpara>
29+
Renvoie la fonction de gestion d'erreur définie.
30+
Si le gestionnaire par défaut est utilisé, &null; est renvoyé.
31+
</simpara>
32+
<simpara>
33+
Le gestionnaire retourné est la fonction de rappel exacte qui a été passé
34+
à <function>set_error_handler</function> pour la définir.
35+
</simpara>
36+
</refsect1>
37+
38+
<refsect1 role="examples">
39+
&reftitle.examples;
40+
<para>
41+
<example>
42+
<title>Exemple de <function>get_error_handler</function></title>
43+
<programlisting role="php">
44+
<![CDATA[
45+
<?php
46+
47+
$handler = function (int $errno, string $errstr, ?string $errfile, ?int $errline) {
48+
echo "Error: " . $errstr . "\n";
49+
};
50+
51+
var_dump(get_error_handler()); // NULL
52+
53+
set_error_handler($handler);
54+
55+
var_dump(get_error_handler() === $handler); // bool(true)
56+
57+
?>
58+
]]>
59+
</programlisting>
60+
</example>
61+
</para>
62+
</refsect1>
63+
64+
<refsect1 role="notes">
65+
&reftitle.notes;
66+
<tip>
67+
<simpara>
68+
Auparavant à PHP 8.5.0, cette fonctionnalité peut être fournie par le
69+
polyfill suivant :
70+
</simpara>
71+
<informalexample>
72+
<programlisting role="php">
73+
<![CDATA[
74+
<?php
75+
if (!function_exists('get_error_handler')) {
76+
function noop_error_handler() {
77+
}
78+
function get_error_handler(): ?callable {
79+
$handler = set_error_handler('noop_error_handler');
80+
restore_error_handler();
81+
return $handler;
82+
}
83+
}
84+
?>
85+
]]>
86+
</programlisting>
87+
</informalexample>
88+
</tip>
89+
</refsect1>
90+
91+
<refsect1 role="seealso">
92+
&reftitle.seealso;
93+
<para>
94+
<simplelist>
95+
<member><function>error_reporting</function></member>
96+
<member><function>set_error_handler</function></member>
97+
<member><function>restore_error_handler</function></member>
98+
<member><function>trigger_error</function></member>
99+
<member><link linkend="errorfunc.constants">constante de niveau d'erreur</link></member>
100+
</simplelist>
101+
</para>
102+
</refsect1>
103+
</refentry>
104+
<!-- Keep this comment at the end of the file
105+
Local variables:
106+
mode: sgml
107+
sgml-omittag:t
108+
sgml-shorttag:t
109+
sgml-minimize-attributes:nil
110+
sgml-always-quote-attributes:t
111+
sgml-indent-step:1
112+
sgml-indent-data:t
113+
indent-tabs-mode:nil
114+
sgml-parent-document:nil
115+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
116+
sgml-exposed-tags:nil
117+
sgml-local-catalogs:nil
118+
sgml-local-ecat-files:nil
119+
End:
120+
vim600: syn=xml fen fdm=syntax fdl=2 si
121+
vim: et tw=78 syn=sgml
122+
vi: ts=1 sw=1
123+
-->
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 4a6671fe697ead5b27603b56face01a2c4e7ebe5 Maintainer: Fan2Shrek Status: ready -->
3+
<!-- Reviewed: yes -->
4+
<refentry xml:id="function.get-exception-handler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>get_exception_handler</refname>
7+
<refpurpose>Renvoie la fonction de gestion d'exception définie par l'utilisateur</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type class="union"><type>callable</type><type>null</type></type><methodname>get_exception_handler</methodname>
14+
<void/>
15+
</methodsynopsis>
16+
<simpara>
17+
Renvoie la fonction de gestion d'exception définie par l'utilisateur, si une a été définie.
18+
</simpara>
19+
</refsect1>
20+
21+
<refsect1 role="parameters">
22+
&reftitle.parameters;
23+
&no.function.parameters;
24+
</refsect1>
25+
26+
<refsect1 role="returnvalues">
27+
&reftitle.returnvalues;
28+
<simpara>
29+
Renvoie la fonction de gestion d'exception définie.
30+
Si aucune n'est définie, &null; est renvoyé.
31+
</simpara>
32+
<simpara>
33+
Le gestionnaire retourné est la fonction de rappel exacte qui a été passé
34+
à <function>set_exception_handler</function> pour la définir.
35+
</simpara>
36+
</refsect1>
37+
38+
<refsect1 role="examples">
39+
&reftitle.examples;
40+
<para>
41+
<example>
42+
<title>Exemple de <function>get_exception_handler</function></title>
43+
<programlisting role="php">
44+
<![CDATA[
45+
<?php
46+
47+
$handler = function (Throwable $ex) {
48+
echo "Exception: " . $ex::class . ": " . $ex->getMessage() . "\n";
49+
};
50+
51+
var_dump(get_exception_handler()); // NULL
52+
53+
set_exception_handler($handler);
54+
55+
var_dump(get_exception_handler() === $handler); // bool(true)
56+
57+
?>
58+
]]>
59+
</programlisting>
60+
</example>
61+
</para>
62+
</refsect1>
63+
64+
<refsect1 role="notes">
65+
&reftitle.notes;
66+
<tip>
67+
<simpara>
68+
Auparavant PHP 8.5.0, cette fonctionnalité pouvait être fournie par le
69+
polyfill suivant :
70+
</simpara>
71+
<informalexample>
72+
<programlisting role="php">
73+
<![CDATA[
74+
<?php
75+
if (!function_exists('get_exception_handler')) {
76+
function noop_exception_handler() {
77+
}
78+
function get_exception_handler(): ?callable {
79+
$handler = set_exception_handler('noop_exception_handler');
80+
restore_exception_handler();
81+
return $handler;
82+
}
83+
}
84+
?>
85+
]]>
86+
</programlisting>
87+
</informalexample>
88+
</tip>
89+
</refsect1>
90+
91+
<refsect1 role="seealso">
92+
&reftitle.seealso;
93+
<para>
94+
<simplelist>
95+
<member><function>set_exception_handler</function></member>
96+
<member><function>restore_exception_handler</function></member>
97+
<member><function>restore_error_handler</function></member>
98+
<member><function>error_reporting</function></member>
99+
<member><link linkend="language.exceptions">Exceptions</link></member>
100+
</simplelist>
101+
</para>
102+
</refsect1>
103+
</refentry>
104+
<!-- Keep this comment at the end of the file
105+
Local variables:
106+
mode: sgml
107+
sgml-omittag:t
108+
sgml-shorttag:t
109+
sgml-minimize-attributes:nil
110+
sgml-always-quote-attributes:t
111+
sgml-indent-step:1
112+
sgml-indent-data:t
113+
indent-tabs-mode:nil
114+
sgml-parent-document:nil
115+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
116+
sgml-exposed-tags:nil
117+
sgml-local-catalogs:nil
118+
sgml-local-ecat-files:nil
119+
End:
120+
vim600: syn=xml fen fdm=syntax fdl=2 si
121+
vim: et tw=78 syn=sgml
122+
vi: ts=1 sw=1
123+
-->

0 commit comments

Comments
 (0)