Revision: 2834
Author: pekka.klarck
Date: Sat Apr 3 06:09:21 2010
Log: regen
http://code.google.com/p/robotframework/source/detail?r=2834
Modified:
/trunk/doc/userguide/RobotFrameworkUserGuide.html
=======================================
--- /trunk/doc/userguide/RobotFrameworkUserGuide.html Mon Mar 29 06:05:33
2010
+++ /trunk/doc/userguide/RobotFrameworkUserGuide.html Sat Apr 3 06:09:21
2010
@@ -3850,10 +3850,10 @@
the scalar variable is replaced with the value it has. The value may
be any object. When a scalar variable is used in a test data cell with
anything else (constant strings or other variables), its value is
-first converted into a string and then catenated to whatever is in
+first converted into a Unicode string and then catenated to whatever is in
that cell. Converting the value into a string means that the object's
-method <span class="code">__str__</span> (in Python) or <span
class="code">toString</span> (in Java) is
-called.</p>
+method <span class="code">__unicode__</span> (in Python, with <span
class="code">__str__</span> as a fallback)
+or <span class="code">toString</span> (in Java) is called.</p>
<p>The example below demonstrates the difference between having a
variable in a cell alone or with other content. First, let us assume
that we have a variable <span class="var">${STR}</span> set to a string
<span class="code">Hello,
@@ -3913,6 +3913,16 @@
<li><span class="name">KW 3</span> gets a string <span class="code">I said
"Hello, world!"</span></li>
<li><span class="name">KW 4</span> gets a string <span class="code">You
said "Hi, tellus!"</span></li>
</ul>
+<div class="note">
+<p class="first admonition-title">Note</p>
+<p class="last">Converting variables to Unicode obviously fails if the
variable
+cannot be represented as Unicode. This can happen, for example,
+if you try to use byte sequences as arguments to keywords so that
+you catenate the values together like <span
class="code">${byte1}${byte2}</span>.
+A workaround is creating a variable that contains the whole value
+and using it alone in the cell (e.g. <span class="code">${bytes}</span>)
as then
+the value is used as-is.</p>
+</div>
</div>
<div class="section" id="list-variables">
<h4><a class="toc-backref" href="#id307">List variables</a></h4>
@@ -10928,9 +10938,12 @@
<li>starttime: execution start time</li>
<li>metadata: a dictionary containing <a class="reference internal"
href="#free-test-suite-metadata">free test
suite metadata</a></li>
-<li>testcount: number of tests in this suite</li>
-<li>suitecount: number of subsuites this suite has</li>
-<li>totaltests: number of tests in all subsuites</li>
+<li>tests: names of tests directly in this suite
+as a list of strings</li>
+<li>suites: names of suites directly in this suite
+as a list of strings</li>
+<li>totaltests: total number of tests in this suite
+and all its sub-suites as an integer</li>
</ul>
<p class="last">The last four were added in Robot Framework 2.5</p>
</td>
@@ -12168,7 +12181,7 @@
<div class="footer">
<hr class="footer" />
<p>Generated by <a class="reference external"
href="http://docutils.sourceforge.net/rst.html";>reStructuredText</a>.
Syntax highlighting by <a class="reference external"
href="http://pygments.org/";>Pygments</a>.</p>
-<p>Generated on: 2010-03-29 13:04 UTC.
+<p>Generated on: 2010-04-03 13:06 UTC.
</p>
</div>
--
To unsubscribe, reply using "remove me" as the subject.
