<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html lang='en'> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" > <title>dyaml.loader - D:YAML 0.4 API documentation</title> <link rel="stylesheet" type="text/css" href="css/style.css"> </head> <body><div id="top"> <div id="header"> <img id="logo" alt="D:YAML logo" src="images/logo.png"><a id="main-heading" href="index.html">D:YAML 0.4 API documentation</a> </div> </div> <div id="navigation"> <div class="navblock"> <div id="toctop"> <ul><li><a href="../index.html">Documentation home</a></li> </ul> </div> </div> <div class="navblock"> <ul><li><a href="index.html">Main page</a></li> <li><a href="dyaml.constructor.html">dyaml.constructor</a></li> <li><a href="dyaml.dumper.html">dyaml.dumper</a></li> <li><a href="dyaml.encoding.html">dyaml.encoding</a></li> <li><a href="dyaml.exception.html">dyaml.exception</a></li> <li><a href="dyaml.hacks.html">dyaml.hacks</a></li> <li><a href="dyaml.linebreak.html">dyaml.linebreak</a></li> <li><a href="dyaml.loader.html">dyaml.loader</a></li> <li><a href="dyaml.node.html">dyaml.node</a></li> <li><a href="dyaml.representer.html">dyaml.representer</a></li> <li><a href="dyaml.resolver.html">dyaml.resolver</a></li> <li><a href="dyaml.style.html">dyaml.style</a></li> </ul> </div> </div> <div id="content"> <h1>dyaml.loader</h1> <!-- Generated by Ddoc from dyaml/loader.d --> <p>Class used to load YAML documents.</p> <dl><dt class="d_decl"><a name="Loader"></a>struct <a name="Loader"></a><span class="ddoc_psymbol">Loader</span>; </dt> <dd><p>Loads YAML documents from files or streams. </p> <p>User specified Constructor and/or Resolver can be used to support new tags / data types. </p> <b>Examples:</b><div class="pbr">Load single YAML document from a file: <pre class="d_code"><span class="d_keyword">auto</span> rootNode = <span class="d_psymbol">Loader</span>(<span class="d_string">"file.yaml"</span>).load(); ... </pre> <br> Load all YAML documents from a file: <pre class="d_code"><span class="d_keyword">auto</span> nodes = <span class="d_psymbol">Loader</span>(<span class="d_string">"file.yaml"</span>).loadAll(); ... </pre> <br> Iterate over YAML documents in a file, lazily loading them: <pre class="d_code"><span class="d_keyword">auto</span> loader = <span class="d_psymbol">Loader</span>(<span class="d_string">"file.yaml"</span>); <span class="d_keyword">foreach</span>(<span class="d_keyword">ref</span> node; loader) { ... } </pre> <br> Load YAML from memory: <pre class="d_code"><span class="d_keyword">import</span> std.stream; <span class="d_keyword">import</span> std.stdio; string yaml_input = <span class="d_string">"red: '#ff0000'\n"</span> <span class="d_string">"green: '#00ff00'\n"</span> <span class="d_string">"blue: '#0000ff'"</span>; <span class="d_keyword">auto</span> colors = <span class="d_psymbol">Loader</span>.fromString(yaml_input).load(); <span class="d_keyword">foreach</span>(string color, string value; colors) { writeln(color, <span class="d_string">" is "</span>, value, <span class="d_string">" in HTML/CSS"</span>); } </pre> <br> Use a custom constructor/resolver to support custom data types and/or implicit tags: <pre class="d_code"><span class="d_keyword">auto</span> constructor = <span class="d_keyword">new</span> Constructor(); <span class="d_keyword">auto</span> resolver = <span class="d_keyword">new</span> Resolver(); <span class="d_comment">//Add constructor functions / resolver expressions here... </span> <span class="d_keyword">auto</span> loader = <span class="d_psymbol">Loader</span>(<span class="d_string">"file.yaml"</span>); loader.constructor = constructor; loader.resolver = resolver; <span class="d_keyword">auto</span> rootNode = loader.load(node); </pre> </div> <dl><dt class="d_decl"><a name="Loader.this"></a>@trusted this(string <b>filename</b>); </dt> <dd><p>Construct a Loader to load YAML from a file. </p> <b>Parameters:</b><div class="pbr"><table class=parms><tr><td valign=top>string <b>filename</b></td> <td valign=top>Name of the file to load from.</td></tr> </table></div> <b>Throws:</b><div class="pbr">YAMLException if the file could not be opened or read.</div> </dd> <dt class="d_decl"><a name="Loader.fromString"></a>static Loader <a name="fromString"></a><span class="ddoc_psymbol">fromString</span>(string <b>data</b>); </dt> <dd><p>Construct a Loader to load YAML from a string. </p> <b>Parameters:</b><div class="pbr"><table class=parms><tr><td valign=top>string <b>data</b></td> <td valign=top>String to load YAML from.</td></tr> </table></div> <b>Returns:</b><div class="pbr">Loader loading YAML from given string.</div> </dd> <dt class="d_decl"><a name="Loader.this"></a>@safe this(Stream <b>stream</b>); </dt> <dd><p>Construct a Loader to load YAML from a stream. </p> <b>Parameters:</b><div class="pbr"><table class=parms><tr><td valign=top>Stream <b>stream</b></td> <td valign=top>Stream to read from. Must be readable and seekable.</td></tr> </table></div> <b>Throws:</b><div class="pbr">YAMLException if <b>stream</b> could not be read.</div> </dd> <dt class="d_decl"><a name="Loader.name"></a>pure nothrow @property @safe void <a name="name"></a><span class="ddoc_psymbol">name</span>(string <a name="name"></a><span class="ddoc_psymbol">name</span>); </dt> <dd><p>Set stream name. Used in debugging messages.</p> </dd> <dt class="d_decl"><a name="Loader.resolver"></a>pure nothrow @property @safe void <a name="resolver"></a><span class="ddoc_psymbol">resolver</span>(Resolver <a name="resolver"></a><span class="ddoc_psymbol">resolver</span>); </dt> <dd><p>Specify custom Resolver to use.</p> </dd> <dt class="d_decl"><a name="Loader.constructor"></a>pure nothrow @property @safe void <a name="constructor"></a><span class="ddoc_psymbol">constructor</span>(Constructor <a name="constructor"></a><span class="ddoc_psymbol">constructor</span>); </dt> <dd><p>Specify custom Constructor to use.</p> </dd> <dt class="d_decl"><a name="Loader.load"></a>@safe Node <a name="load"></a><span class="ddoc_psymbol">load</span>(); </dt> <dd><p>Load single YAML document. </p> <p>If none or more than one YAML document is found, this throws a YAMLException. <br> This can only be called once; this is enforced by contract. </p> <b>Returns:</b><div class="pbr">Root node of the document. </div> <b>Throws:</b><div class="pbr">YAMLException if there wasn't exactly one document or on a YAML parsing error.</div> </dd> <dt class="d_decl"><a name="Loader.loadAll"></a>@safe Node[] <a name="loadAll"></a><span class="ddoc_psymbol">loadAll</span>(); </dt> <dd><p>Load all YAML documents. </p> <p>This is just a shortcut that iterates over all documents and returns them all at once. Calling <a name="loadAll"></a><span class="ddoc_psymbol">loadAll</span> after iterating over the node or vice versa will not return any documents, as they have all been parsed already. <br> This can only be called once; this is enforced by contract. </p> <b>Returns:</b><div class="pbr">Array of root nodes of all documents in the file/stream. </div> <b>Throws:</b><div class="pbr">YAMLException on a parsing error.</div> </dd> <dt class="d_decl"><a name="Loader.opApply"></a>@trusted int <a name="opApply"></a><span class="ddoc_psymbol">opApply</span>(int delegate(ref Node) <b>dg</b>); </dt> <dd><p>Foreach over YAML documents. </p> <p>Parses documents lazily, when they are needed. <br> Foreach over a Loader can only be used once; this is enforced by contract. </p> <b>Throws:</b><div class="pbr">YAMLException on a parsing error.</div> </dd> </dl> </dd> </dl> </div> <div id="copyright"> Copyright © Ferdinand Majerech 2011. Based on <a href="http://www.pyyaml.org">PyYAML</a> by Kirill Simonov. | Page generated by AutoDDoc and <a href="http://www.digitalmars.com/d/2.0/ddoc.html">Ddoc</a>. </div> </body> </html>