<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet href="../../make-menu.xsl" type="text/xsl"?><html>
   <head>
      <this-is section="extensions" page="attributes" subpage="read-once"/>
      <!--
           Generated at 2011-12-09T20:47:22.916Z--><title>Saxonica: XSLT and XQuery Processing: saxon:read-once</title>
      <meta name="coverage" content="Worldwide"/>
      <meta name="copyright" content="Copyright Saxonica Ltd"/>
      <meta name="title" content="Saxonica: XSLT and XQuery Processing: saxon:read-once"/>
      <meta name="robots" content="noindex,nofollow"/>
      <link rel="stylesheet" href="../../saxondocs.css" type="text/css"/>
   </head>
   <body class="main">
      <h1>saxon:read-once</h1>
      <p>This attribute may be set on the <code>xsl:copy-of</code> element. The allowed values are
"yes" and "no". If set to yes, this attribute enables the optimization
described in <a class="bodylink" href="../../sourcedocs/streaming/burst-mode-streaming.xml">Streaming of Large Documents</a>.</p>
      <p>The attribute should be set to "yes" only if any external document read by this instruction is read at most
once by the stylesheet. If this is not the case, the optimization is unsafe, since the functions <code>doc()</code>
and <code>document()</code> are required to return the same results each time they are called.</p>
      <p><i>Streaming is available only with Saxon-EE.</i></p>
      <table width="100%">
         <tr>
            <td>
               <p align="right"><a class="nav" href="threads.xml">Next</a></p>
            </td>
         </tr>
      </table>
   </body>
</html>