Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
no edit summary
{{Announce|Updated with Version 10:}} Renamed from ''Strings Module'' to ''String Module''. The namespace URI has been updated as well.
This [[Module Library|XQuery Module]] contains functions for string operations and computations.
=Conventions=
All functions and errors in this module and errors are assigned to the <code><nowiki>http://basex.org/modules/string</nowiki></code> namespace, which is statically bound to the {{Code|string}} prefix.<br/>
=FunctionsComputations=
==string:levenshtein==
* <code>string:cologne-phonetic("Michael")</code> returns {{Code|645}}
* <code>every $s in ("Mayr", "Maier", "Meier") satisfies string:cologne-phonetic($s) = "67"</code> returns {{Code|true}}
|}
=Formatting=
{{Announce|The functions in this section have been adopted from the obsolete Output Module.}}
==string:format==
{| width='100%'
|- valign="top"
| width='120' | '''Signatures'''
|{{Func|string:format|$format as xs:string, $items as item() ...|xs:string}}<br />
|- valign="top"
| '''Summary'''
|Returns a formatted string. The remaining arguments specified by {{Code|$items}} are applied to the {{Code|$format}} string, according to [https://docs.oracle.com/javase/8/docs/api/java/util/Formatter.html#syntax Java’s printf syntax].
|- valign="top"
| '''Errors'''
|{{Error|format|#Errors}} The specified format is not valid.
|- valign="top"
| '''Examples'''
|
* {{Code|string:format("%b", true())}} returns {{Code|true}}.
* {{Code|string:format("%06d", 256)}} returns {{Code|000256}}.
* {{Code|string:format("%e", 1234.5678)}} returns {{Code|1.234568e+03}}.
|}
==string:cr==
{| width='100%'
|- valign="top"
| width='120' | '''Signatures'''
|{{Code|'''string:cr()''' as xs:string}}
|- valign="top"
| '''Summary'''
|Returns a single carriage return character ({{Code|&#13;}}).
|}
==string:nl==
{| width='100%'
|- valign="top"
| width='120' | '''Signatures'''
|{{Code|'''string:nl()''' as xs:string}}
|- valign="top"
| '''Summary'''
|Returns a single newline character ({{Code|&#10;}}).
|}
==string:tab==
{| width='100%'
|- valign="top"
| width='120' | '''Signatures'''
|{{Code|'''string:tab()''' as xs:string}}
|- valign="top"
| '''Summary'''
|Returns a single tabulator character ({{Code|&#9;}}).
|}
;Version 10.0
* Updated: Renamed from ''Strings Module'' to ''String Module''. The namespace URI has been updated as well.
* Updated: {{Function||string:format}}, {{Function||string:cr}}, {{Function||string:nl}} and {{Function||string:tab}} adopted from the obsolete Output Module.
The Module was introduced with Version 8.3. Functions were adopted from the obsolete Utility and Output Modules.
