Adobe ColdFusion 8

Right

Description

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

Returns the specified number of characters from the end (or right side) of the specified string.

Returns

  • 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

Category

String functions

Function syntax

Right(string, count)

See also

Left, Mid, Reverse

Parameters

Parameter

Description

string

A string or a variable that contains one.

count

A positive integer that specifies the number of characters to return.

Example

<!--- Simple Right Example--->
<cfoutput>
#Right("See the quick red fox jump over the fence", 9)#
<br>
#Right("ColdFusion", 6)#
</cfoutput>

<!--- Right Example using form input --->
<h3>Right Example</h3>
<cfif IsDefined("Form.MyText")>
<!--- If len returns 0 (zero), then show error message. --->
    <cfif Len(FORM.myText)>
        <cfif Len(FORM.myText) LTE FORM.RemoveChars>
            <cfoutput><p style="color: red; font-weight: bold">Your string
            #FORM.myText# only has #Len(FORM.myText)# characters. You cannot output
            the #FORM.removeChars# rightmost characters of this string because it 
            is not long enough.</p></cfoutput>
        <cfelse>
            <cfoutput><p>Your original string: <strong>#FORM.myText#</strong>
            <p>Your changed string, showing only the <strong>#FORM.removeChars#
            </strong> rightmost characters:
            <strong>#right(Form.myText, FORM.removeChars)#</strong></p>
            </cfoutput>
        </cfif> 
    <cfelse>
        <p style="color: red; font-weight: bold">Please enter a string of more
        than 0 (zero) characters.</p>
    </cfif>
</cfif>

<form action="<cfoutput>#CGI.ScriptName#</cfoutput>" method="POST">
<p>Type in some text<br />
<input type="Text" name="myText"></p>
<p>How many characters from the right 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="Submit" value="Remove characters"></p>
</form>