1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
3
<!-- Documenting PadLeft-->
5
<meta http-equiv="Content-Language" content="en-ca" />
6
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
<link rel="stylesheet" type="text/css" href="../style.css" />
8
<title>string::pad-left Function</title>
11
<table width="100%" border="0" cellspacing="0" cellpadding="2" class="NavBar">
13
<td class="NavBar-Cell">
14
<a href="http://nant.sourceforge.net">
17
<img alt="->" src="../images/arrow.gif" />
18
<a href="../index.html">Help</a>
19
<img alt="->" src="../images/arrow.gif" />
20
<a href="index.html">Function Reference</a>
21
<img alt="->" src="../images/arrow.gif" /> string::pad-left</td>
22
<td class="NavBar-Cell" align="right">
26
<h1>string::pad-left</h1>
27
<p> Returns the given string left-padded to the given length. </p>
29
<code>string string::pad-left(<span class="parameter">s</span>, <span class="parameter">totalWidth</span>, <span class="parameter">paddingChar</span>)
43
<td>The <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemStringClassTopic.asp">String</a> that needs to be left-padded.</td>
48
<td>The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.</td>
53
<td>A Unicode padding character.</td>
57
<h3>Return Value</h3> If the length of <i>s</i> is at least <i>totalWidth</i>, then a new <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemStringClassTopic.asp">String</a> identical to <i>s</i> is returned. Otherwise, <i>s</i> will be padded on the left with as many <i>paddingChar</i> characters as needed to create a length of <i>totalWidth</i>. <h3>Exceptions</h3>
58
The function will fail in any of the following circumstances:
59
<div style="margin-left: 40px;"><ul><li><i>totalWidth</i> is less than zero.</li></ul></div><h3>Remarks</h3> Note that only the first character of <i>paddingChar</i> will be used when padding the result. <h3>Examples</h3><ul class="examples"><li><pre class="code">string::pad-left('test', 10, ' ') ==> ' test'</pre></li><li><pre class="code">string::pad-left('test', 10, 'test') ==> 'tttttttest'</pre></li><li><pre class="code">string::pad-left('test', 3, ' ') ==> 'test'</pre></li><li><pre class="code">string::pad-left('test', -4, ' ') ==> ERROR</pre></li></ul><h3>Requirements</h3><div style="margin-left: 20px;"><b>Assembly:</b> NAnt.Core (0.90.3780.0)
b'\\ No newline at end of file'