| CFML Reference
|
|
ColdFusion Functions
|
Left
Description
Returns the count of characters from the beginning of a string argument.
Category
String functions
Syntax
Left(string, count)
See also
Right, Mid, Len
Parameters
| Parameter |
Description |
string
|
String from which the leftmost characters are retrieved
|
count
|
Positive integer; number of characters to return
|
Example <!--- This example shows the use of Left --->
<html>
<head>
<title>Left Example</title>
</head>
<body bgcolor = silver>
<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>
...
|
Copyright © 2001, Macromedia Inc. All rights reserved. |
|
|
