socket-last-error.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- splitted from ./it/functions/sockets.xml, last change in rev 1.1 -->
<!-- EN-Revision: n/a Maintainer: darvina Status: ready -->
  <refentry xml:id="function.socket-last-error" xmlns="http://docbook.org/ns/docbook">
   <refnamediv>
    <refname>socket_last_error</refname>
    <refpurpose>Restituisce l'ultimo errore su un socket. </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>socket_last_error</methodname>
      <methodparam choice="opt"><type>resource</type><parameter>socket</parameter></methodparam>
     </methodsynopsis>
     &warn.experimental.func;
    <para>
     Questa funzione restituisce il codice di errore di un socket.
    </para>
    <para> 
     Se a questa funzione si passa una risorsa di tipo socket, essa restituisce
     l'ultimo errore occorso in quel socket. Se, al contrario, si omette di indicare il
     socket, verrà restituito l'ultimo errore generato dalle funzioni dei socket.
     Il secondo caso è particolarmente utile per funzioni tipo
     <function>socket_create</function>, che in caso di errore non restituiscono un
     socket, o <function>socket_select</function>, che possono fallire per ragioni
     non direttamente collegate ad un particolare socket. Il codice di errore è 
     utilizzabile dalla funzione <function>socket_strerror</function> per ottenere un testo
     con la spiegazione del codice di errore dato.
     <programlisting role="php"> 
<![CDATA[ 
<?php
if (false == ($socket = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP))) { 
    die("Non si riesce a creare il socket, codice di errore: " . socket_last_error() . 
        ",descrizione: " . socket_strerror(socket_last_error())); 
} 
?>
]]> 
     </programlisting> 
    </para> 
    <note> 
     <para> 
      <function>socket_last_error</function> non rimuove il codice di errore, utilizzare
      <function>socket_clear_error</function> per questo scopo. 
     </para> 
    </note> 
   </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
-->