Left

Description

Determines the number of characters from the beginning of the string parameter to the location specified by the count parameter.

Return value

Number; count of characters.

Category

String functions

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>

Comments