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

<refentry xml:id="function.socket-strerror" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>socket_strerror</refname>

<refpurpose>Restituisce una stringa con la descrizione dell'errore.</refpurpose>

</refnamediv>

<refsect1>

<title>Descrizione</title>

<methodsynopsis>

<type>string</type><methodname>socket_strerror</methodname>

<methodparam><type>int</type><parameter>errno</parameter></methodparam>

</methodsynopsis>

&warn.experimental.func;

<para>

La funzione <function>socket_strerror</function> utilizza come proprio

parametro <parameter>errno</parameter> il codice di errore di un socket fornito da

<function>socket_last_error</function> e restituisce il corrispondente testo

descrittivo. Questo rende più semplice piegare cosa è accaduto quando qualcosa

non funziona; ad esempio, invece di dovere cercare in tutto il

sistema un file che contenga la spiegazione di '-111', si può semplicemente

passare il valore a <function>socket_strerror</function>, e ottenere la

spiegazione di ciò che è accaduto.

</para>

<para>

<example>

<title>Esempio di uso di <function>socket_strerror</function></title>

<programlisting role="php">

</programlisting>

<para>

Dall'esempio precedente (se non viene eseguito con i

privilegi di root) ci si aspetta il seguente messaggio:

<screen>

socket_bind() fallito: motivo: Permission denied

</screen>

</para>

</example>

</para>

<para>

Vedere anche

<function>socket_accept</function>,

<function>socket_bind</function>,

<function>socket_connect</function>,

<function>socket_listen</function> e

<function>socket_create</function>.

</para>

</refsect1>

</refentry>