debian-packages/dyaml
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
dyaml/doc/html/api/dyaml.loader.html

198 lines
7.3 KiB
HTML
Raw Normal View History

Initial commit.
2011-08-16 12:53:13 +00:00
<!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" >
Updated DMD links.
2012-01-23 17:40:05 +00:00
<title>dyaml.loader - D:YAML 0.4 API documentation</title>
Initial commit.
2011-08-16 12:53:13 +00:00
<link rel="stylesheet" type="text/css" href="css/style.css">
</head>
<body><div id="top">
<div id="header">
Updated DMD links.
2012-01-23 17:40:05 +00:00
<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>
Initial commit.
2011-08-16 12:53:13 +00:00
</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>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<li><a href="dyaml.dumper.html">dyaml.dumper</a></li>
<li><a href="dyaml.encoding.html">dyaml.encoding</a></li>
Initial commit.
2011-08-16 12:53:13 +00:00
<li><a href="dyaml.exception.html">dyaml.exception</a></li>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<li><a href="dyaml.linebreak.html">dyaml.linebreak</a></li>
Initial commit.
2011-08-16 12:53:13 +00:00
<li><a href="dyaml.loader.html">dyaml.loader</a></li>
<li><a href="dyaml.node.html">dyaml.node</a></li>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<li><a href="dyaml.representer.html">dyaml.representer</a></li>
Initial commit.
2011-08-16 12:53:13 +00:00
<li><a href="dyaml.resolver.html">dyaml.resolver</a></li>
Updated Representer API doc, minor documentation changes.
2011-10-29 18:43:30 +00:00
<li><a href="dyaml.style.html">dyaml.style</a></li>
Initial commit.
2011-08-16 12:53:13 +00:00
</ul>
</div>
</div>
<div id="content">
<h1>dyaml.loader</h1>
<!-- Generated by Ddoc from dyaml/loader.d -->
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<p>Class used to load YAML documents.</p>
Initial commit.
2011-08-16 12:53:13 +00:00
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dl><dt class="d_decl">struct <a name="Loader"></a><span class="ddoc_psymbol">Loader</span>;
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dd><p>Loads YAML documents from files or streams.
Initial commit.
2011-08-16 12:53:13 +00:00
</p>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<p>User specified Constructor and/or Resolver can be used to support new
tags / data types.
Initial commit.
2011-08-16 12:53:13 +00:00
</p>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<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>
Initial commit.
2011-08-16 12:53:13 +00:00
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
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>
Initial commit.
2011-08-16 12:53:13 +00:00
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
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>);
Initial commit.
2011-08-16 12:53:13 +00:00
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<span class="d_keyword">foreach</span>(<span class="d_keyword">ref</span> node; loader)
{
...
}
</pre>
Initial commit.
2011-08-16 12:53:13 +00:00
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
Load YAML from memory:
Initial commit.
2011-08-16 12:53:13 +00:00
<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>;
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<span class="d_keyword">auto</span> colors = <span class="d_psymbol">Loader</span>(<span class="d_keyword">new</span> MemoryStream(<span class="d_keyword">cast</span>(<span class="d_keyword">char</span>[])yaml_input)).load();
Initial commit.
2011-08-16 12:53:13 +00:00
<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>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
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>
Initial commit.
2011-08-16 12:53:13 +00:00
</div>
Reader was reimplemented. After experiments with loading the whole file at once, and with decoding and parsing in separate thread, lazy reader turned to be the fastest/least memory intensive solution. Characters are now decoded in small batches. This improved parsing speed by ~20%. No global state anymore. Anchors are now zero terminated strings and TagDirectives are a simple array. Event structure was changed to prevent size increase. Minor fixes and improvements.
2011-11-16 02:10:29 +00:00
<dl><dt class="d_decl">this(string <b>filename</b>);
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dd><p>Construct a Loader to load YAML from a file.
Initial commit.
2011-08-16 12:53:13 +00:00
</p>
Reader was reimplemented. After experiments with loading the whole file at once, and with decoding and parsing in separate thread, lazy reader turned to be the fastest/least memory intensive solution. Characters are now decoded in small batches. This improved parsing speed by ~20%. No global state anymore. Anchors are now zero terminated strings and TagDirectives are a simple array. Event structure was changed to prevent size increase. Minor fixes and improvements.
2011-11-16 02:10:29 +00:00
<b>Parameters:</b><div class="pbr"><table class=parms><tr><td valign=top>string <b>filename</b></td>
Initial commit.
2011-08-16 12:53:13 +00:00
<td valign=top>Name of the file to load from.</td></tr>
</table></div>
Cleaned up exceptions and their messages. Some minor dog fixes.
2011-10-18 14:12:22 +00:00
<b>Throws:</b><div class="pbr">YAMLException if the file could not be opened or read.</div>
Initial commit.
2011-08-16 12:53:13 +00:00
</dd>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dt class="d_decl">this(Stream <b>stream</b>);
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dd><p>Construct a Loader to load YAML from a stream.
Initial commit.
2011-08-16 12:53:13 +00:00
</p>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<b>Parameters:</b><div class="pbr"><table class=parms><tr><td valign=top>Stream <b>stream</b></td>
Nodes now remember their scalar and collection style, although these are not accessible by the user (as the spec says). This allows D:YAML to remember styles between loading and dumping.
2011-10-27 21:13:14 +00:00
<td valign=top>Stream to read from. Must be readable and seekable.</td></tr>
Initial commit.
2011-08-16 12:53:13 +00:00
</table></div>
Cleaned up exceptions and their messages. Some minor dog fixes.
2011-10-18 14:12:22 +00:00
<b>Throws:</b><div class="pbr">YAMLException if <b>stream</b> could not be read.</div>
Initial commit.
2011-08-16 12:53:13 +00:00
</dd>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dt class="d_decl">@property void <a name="name"></a><span class="ddoc_psymbol">name</span>(string <a name="name"></a><span class="ddoc_psymbol">name</span>);
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dd><p>Set stream name. Used in debugging messages.</p>
Initial commit.
2011-08-16 12:53:13 +00:00
</dd>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dt class="d_decl">@property void <a name="resolver"></a><span class="ddoc_psymbol">resolver</span>(Resolver <a name="resolver"></a><span class="ddoc_psymbol">resolver</span>);
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dd><p>Specify custom Resolver to use.</p>
Initial commit.
2011-08-16 12:53:13 +00:00
</dd>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dt class="d_decl">@property void <a name="constructor"></a><span class="ddoc_psymbol">constructor</span>(Constructor <a name="constructor"></a><span class="ddoc_psymbol">constructor</span>);
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dd><p>Specify custom Constructor to use.</p>
Initial commit.
2011-08-16 12:53:13 +00:00
</dd>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<dt class="d_decl">Node <a name="load"></a><span class="ddoc_psymbol">load</span>();
Initial commit.
2011-08-16 12:53:13 +00:00
</dt>
<dd><p>Load single YAML document.
</p>
Cleaned up exceptions and their messages. Some minor dog fixes.
2011-10-18 14:12:22 +00:00
<p>If none or more than one YAML document is found, this throws a YAMLException.
Reader was reimplemented. After experiments with loading the whole file at once, and with decoding and parsing in separate thread, lazy reader turned to be the fastest/least memory intensive solution. Characters are now decoded in small batches. This improved parsing speed by ~20%. No global state anymore. Anchors are now zero terminated strings and TagDirectives are a simple array. Event structure was changed to prevent size increase. Minor fixes and improvements.
2011-11-16 02:10:29 +00:00
<br>
This can only be called once; this is enforced by contract.
Initial commit.
2011-08-16 12:53:13 +00:00
</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>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
</dd>
<dt class="d_decl">Node[] <a name="loadAll"></a><span class="ddoc_psymbol">loadAll</span>();
</dt>
<dd><p>Load all YAML documents.
Added a shortcut alias called "as" for Node.get(), and replaced get() with as() all over the code, tutorials, examples and docs. Fixed a bug in YAML benchmark makefile. Fixed a bug in autoddoc configuration.
2011-10-22 15:06:32 +00:00
</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.
Reader was reimplemented. After experiments with loading the whole file at once, and with decoding and parsing in separate thread, lazy reader turned to be the fastest/least memory intensive solution. Characters are now decoded in small batches. This improved parsing speed by ~20%. No global state anymore. Anchors are now zero terminated strings and TagDirectives are a simple array. Event structure was changed to prevent size increase. Minor fixes and improvements.
2011-11-16 02:10:29 +00:00
<br>
This can only be called once; this is enforced by contract.
Added a shortcut alias called "as" for Node.get(), and replaced get() with as() all over the code, tutorials, examples and docs. Fixed a bug in YAML benchmark makefile. Fixed a bug in autoddoc configuration.
2011-10-22 15:06:32 +00:00
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
</p>
<b>Returns:</b><div class="pbr">Array of root nodes of all documents in the file/stream.
</div>
Cleaned up exceptions and their messages. Some minor dog fixes.
2011-10-18 14:12:22 +00:00
<b>Throws:</b><div class="pbr">YAMLException on a parsing error.</div>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
Initial commit.
2011-08-16 12:53:13 +00:00
</dd>
<dt class="d_decl">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>
Updated the API documentation. Updated examples based on the new Loader API. (Dumper API still needs examples)
2011-10-14 08:34:53 +00:00
<p>Parses documents lazily, when they are needed.
Reader was reimplemented. After experiments with loading the whole file at once, and with decoding and parsing in separate thread, lazy reader turned to be the fastest/least memory intensive solution. Characters are now decoded in small batches. This improved parsing speed by ~20%. No global state anymore. Anchors are now zero terminated strings and TagDirectives are a simple array. Event structure was changed to prevent size increase. Minor fixes and improvements.
2011-11-16 02:10:29 +00:00
<br>
Foreach over a Loader can only be used once; this is enforced by contract.
Initial commit.
2011-08-16 12:53:13 +00:00
</p>
<b>Throws:</b><div class="pbr">YAMLException on a parsing error.</div>
</dd>
</dl>
</dd>
</dl>
</div>
<div id="copyright">
Copyright &copy; Ferdinand Majerech 2011. Based on <a href="http://www.pyyaml.org">PyYAML</a> by Kirill Simonov. |
Red-Black Trees are now used for duplicate detection, and planned to be used for unordered map storage. This is because AAs still don't work correctly and even if they did, require the user to define both toHash and opCmp/opEquals for every YAML struct/class. Now only opCmp needs to be defined. Documentation/tutorials/examples have been updated accordingly.
2012-01-23 14:57:26 +00:00
Page generated by AutoDDoc and <a href="http://www.digitalmars.com/d/2.0/ddoc.html">Ddoc</a>.
Initial commit.
2011-08-16 12:53:13 +00:00
</div>
</body>
</html>
Reference in a new issue Copy permalink