Left |
|
 |
Description
|
Returns the leftmost count characters in a string.
|
|
Returns
|
String; the first count characters in the string parameter.
|
|
Category
|
String functions
|
|
Function syntax |
Left(string, count)
|
|
See also
|
Right, Mid, Len
|
|
Parameters
|
|
Parameter |
Description |
string |
A string or a variable that contains one. |
count |
A positive integer or a variable that contains one. Number of characters to return. |
|
|
Example<h3>Left Example</h3>
<cfif IsDefined("Form.MyText")>
<!--- if len is 0, then err --->
<cfif Len(form.myText) is not 0>
<cfif Len(form.myText) LTE form.RemoveChars>
<p>Your string <cfoutput>#form.myText#</cfoutput>
only has <cfoutput>#Len(form.myText)#</cfoutput>
characters. You cannot output the <cfoutput>#form.removeChars#</
cfoutput>
leftmost characters of this string because it is not long enough
<cfelse>
<p>Your original string: <cfoutput>#form.myText#</cfoutput>
<p>Your changed string, showing only the <cfoutput>#form.removeChars#
</cfoutput> leftmost characters:
<cfoutput>#Left(Form.myText, form.removeChars)#</cfoutput>
</cfif>
<cfelse>
<p>Please enter a string
</cfif>
</cfif>
<form action="#CGI.ScriptName#" method="POST">
<p>Type in some text
<br>
<input type="Text" name="MyText">
<p>How many characters from the left do you want to show?
<select name="RemoveChars">
<option value="1">1
<option value="3" selected>3
<option value="5">5
<option value="7">7
<option value="9">9</select>
<input type="Submit" name="Remove characters">
</form>
|