Adobe ColdFusion 8

CJustify

Description

Centers a string in a field length.

Returns

String, center-justified by adding spaces before or after the input parameter. If length is less than the length of the input parameter string, the string is returned unchanged.

Category

Display and formatting functions, String functions

Function syntax

Cjustify(string, length)

See also

LJustify, RJustify

Parameters

Parameter

Description

string

A string or a variable that contains one. May be empty. If it is a variable that is defined as a number, the function processes it as a string.

length

A positive integer or a variable that contains one. Length of field.

Can be coded as:

  • A number; for example, 6
  • A string representation of a number; for example, "6"

Any other value causes ColdFusion to throw an error.

Example

<!--- This example shows how to use CJustify. --->
<CFPARAM name = "jstring" DEFAULT = "">

<cfif IsDefined("FORM.submit")>
<cfdump var="#Form#"> 
    <cfset jstring = Cjustify("#FORM.justifyString#", 35)>
</cfif>
<html>
<head>
<title>CJustify Example</title>
</head>
<body>
<h3>CJustify</h3>
<p>Enter a string; it will be center-justified within the sample field.
<form action = "cjustify.cfm" method="post">
<p><input type = "Text" value = "<cfoutput>#jString#</cfoutput>" 
        size = 35 name = "justifyString">
<p><input type = "Submit" name = "submit"> 
<input type = "RESET">
</form>
</body>
</html>