
Contents > CFML Reference > ColdFusion Functions > Right

Right

Gets a specified number of characters from a string, beginning at the right.

If the length of the string is greater than or equal to count, the rightmost count characters of the string
If count is greater than the length of the string, the whole string
If count is greater than 1, and the string is empty, an empty string

String functions

Right(string, count)

Mid, Left, Reverse

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.

<h3>Right 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>
      rightmost 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> rightmost characters:
      <cfoutput>#right(Form.myText, FORM.removeChars)#
       </cfoutput>
      </cfif>
   <cfelse>
   <p>Please enter a string
   </cfif>
</cfif>


Contents > CFML Reference > ColdFusion Functions > Right

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.