doc-en/reference/errorfunc/functions/restore-error-handler.xml at master · php/doc-en · GitHub

History

104 lines (98 loc) · 2.72 KB

Raw

100

101

102

103

104

<?xml version="1.0" encoding="utf-8"?>

<refname>restore_error_handler</refname>

<refpurpose>Restores the previous error handler function</refpurpose>

</refnamediv>

&reftitle.description;

<type>true</type><methodname>restore_error_handler</methodname>

<void/>

</methodsynopsis>

Pops the error handler that was active before the most recent call to

<function>set_error_handler</function> off the internal stack of error

handlers and makes it active again, together with the

<parameter>error_levels</parameter> mask it was registered with.

The restored handler could be the built-in or a user defined function.

</simpara>

Calling this function more often than <function>set_error_handler</function>

leaves the built-in error handler active; no error is raised.

</simpara>

</refsect1>

&reftitle.parameters;

&no.function.parameters;

</refsect1>

&reftitle.returnvalues;

<para>

&return.true.always;

</para>

</refsect1>

&reftitle.examples;

<para>

<title><function>restore_error_handler</function> example</title>

<para>

Decide if <function>unserialize</function> caused an error, then

restore the original error handler.

</para>

<![CDATA[

<?php

function unserialize_handler($errno, $errstr)

{

echo "Invalid serialized value.\n";

}

$serialized = 'foo';

set_error_handler('unserialize_handler');

$original = unserialize($serialized);

restore_error_handler();

]]>

</programlisting>

&example.outputs;

<![CDATA[

Invalid serialized value.

]]>

</screen>

</example>

</para>

</refsect1>

&reftitle.seealso;

<member><function>error_reporting</function></member>

<member><function>set_error_handler</function></member>

<member><function>get_error_handler</function></member>

<member><function>restore_exception_handler</function></member>

<member><function>trigger_error</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

-->

doc-en/reference/errorfunc/functions/restore-error-handler.xml at master · php/doc-en · GitHub

Uh oh!

Expand file tree

Breadcrumbs

restore-error-handler.xml

Latest commit

History

Breadcrumbs

restore-error-handler.xml

File metadata and controls