picnoir/nix-gh
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Document toString better

Browse source
This commit is contained in:
Linus Heckemann 2017-02-19 18:54:18 +00:00
parent 302386f775
commit b8564987a3
1 changed files with 12 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
doc/manual/expressions/builtins.xml
View file

@ -1023,10 +1023,18 @@ in foo</programlisting>
<listitem><para>Convert the expression
<replaceable>e</replaceable> to a string.
<replaceable>e</replaceable> can be a string (in which case
<function>toString</function> is a no-op), a path (e.g.,
<literal>toString /foo/bar</literal> yields
<literal>"/foo/bar"</literal> or a set containing <literal>{ __toString = self: ...; }</literal>.</para></listitem>
<replaceable>e</replaceable> can be:
<itemizedlist>
<listitem>a string (in which case the string is returned unmodified)</listitem>
<listitem>a path (e.g., <literal>toString /foo/bar</literal> yields <literal>"/foo/bar"</literal></listitem>
<listitem>a set containing <literal>{ __toString = self: ...; }</literal></listitem>
<listitem>an integer</listitem>
<listitem>a list, in which case the string representations of its elements are joined with spaces</listitem>
<listitem>a boolean (<literal>false</literal> yields <literal>""</literal>, <literal>true</literal> yields <literal>"1"</literal></listitem>
<listitem><literal>null</literal>, which yields the empty string.</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>