Whatever message this page gives is out now! Go check it out!

EncodeForDN

Last update:
May 18, 2026
Description
This function encodes the given string for safe output in LDAP Distinguished Names.
Returns
Encoded string
Category
Syntax
encodeForDN (string, [,canonicalize])
History
ColdFusion (2018 release): Renamed parameter inputString to string.
Added in ColdFusion 10.
See also
Parameters
ParameterDescription
stringRequired. The string to encode.
canonicalizeOptional . If set to true, canonicalization happens before encoding. If set to false, the given input string will just be encoded. The default value for  canonicalize  is false. When this parameter is not specified, canonicalization will not happen. By default, when canonicalization is performed, both mixed and multiple encodings will be allowed. To use any other combinations you should canonicalize using canonicalize method and then perform encoding.

Example

<cfscript>
  departmentId = "Human Resources <CTO>";
  searchStart = "ou=" & encodeForDN(departmentId) & ",dc=uconn,dc=edu";
  cfldap(  
             server = "ldap.uconn.edu", 
             action = "query",
             name = "results" ,
             start = "#searchStart#", 
             filter = "cn=Robert Jones" ,
             attributes = "cn,description,o,title,mail,telephonenumber", 
             sort = "cn ASC");
</cfscript>

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page