view release on metacpan or  search on metacpan

doc/html/guide.html  view on Meta::CPAN

		to the result as literals. For example, <span class="quote">&#8220;<span class="quote">{a \{b }</span>&#8221;</span>
		will become <span class="quote">&#8220;<span class="quote">{a {b }</span>&#8221;</span>.
		</p><pre class="programlisting">@results = Triceps::Braced::bunescape_all(@strings);</pre><p>
		Perform the un-escaping on a whole array of strings. The result
		array will contain the same number of elements as the argument.
		</p><pre class="programlisting">$ref_results = Triceps::Braced::split_braced_final($string);
confess "Unbalanced braces around '$string'" if $string;</pre><p>
		The combined functionality of splitting a string and un-escaping
		the result elements. That's why it's final: no further splits must be
		done after un-escaping.  <span class="bold"><strong>The return value is different from the
		other split methods.</strong></span> It is a reference to the array of result
		strings. The difference has been introduced to propagate the <code class="computeroutput">undef</code>
		from the argument to the result: if the argument string is <code class="computeroutput">undef</code>,
		the result will be also <code class="computeroutput">undef</code>, <span class="bold"><strong>not</strong></span> a reference to an
		empty array. The string gets consumed in the same way as for the
		other split methods, and anything left in it indicates an unbalanced
		brace.
		</p></div><div class="sect1" title="19.17. FnReturn reference"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sc_ref_fnreturn"></a>19.17. FnReturn reference</h2></div></div></div><a class="indexterm" name="idm9104">...
		The FnReturn represents the return value of a streaming function.
		The return value consists of a stream of rowops, and gets processed
		by sending them to the labels through a binding.
		</p><pre class="programlisting">$fret = Triceps::FnReturn-&gt;new($optName =&gt; $optValue, ...);</pre><p>
		Construct an FnReturn object. The options are:
		</p><div class="variablelist"><dl><dt><span class="term"><code class="computeroutput">name =&gt; $name</code></span></dt><dd>
			Name of this object. Will be used to create the names of the labels in it.
			</dd><dt><span class="term"><code class="computeroutput">unit =&gt; $unit</code></span></dt><dd>

doc/src/docsrc/760braced.xml  view on Meta::CPAN

<pre>
$ref_results = Triceps::Braced::split_braced_final($string);
confess "Unbalanced braces around '$string'" if $string;
</pre>

		<para>
		The combined functionality of splitting a string and un-escaping
		the result elements. That's why it's final: no further splits must be
		done after un-escaping.  <b>The return value is different from the
		other split methods.</b> It is a reference to the array of result
		strings. The difference has been introduced to propagate the <pre>undef</pre>
		from the argument to the result: if the argument string is <pre>undef</pre>,
		the result will be also <pre>undef</pre>, <b>not</b> a reference to an
		empty array. The string gets consumed in the same way as for the
		other split methods, and anything left in it indicates an unbalanced
		brace.
		</para>

	</sect1>