right
Description
Gets a specified number of characters from a string, beginning at the right.
Categories
Related
Syntax
Right(string, count)
Attributes
| Attribute | Description | Required | Default |
|---|---|---|---|
| count | A positive integer that specifies the number of characters to return. | ||
| string | A string or a variable that contains one. |
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>Your original string: <strong>#FORM.myText#</strong>
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">
Type in some text<br />
<input type="Text" name="myText"></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>