IsUserInAnyRole

Description

Determines whether an authenticated user belongs to any role in a list of roles.

Returns

True, if the authenticated user, belongs to any Role in the list; False, otherwise.

Category

Security functions, Decision functions

Function syntax

IsUserInAnyRole(role_list)

See also

cflogin,cfloginuser, cflogout, GetAuthUser, GetUserRoles, IsUserInRole, IsUserLoggedIn, Securing Applications in the Developing ColdFusion Applications

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description

role_list

A comma-delimited list of one or more roles to be tested.

Example

<cfif IsUserInAnyRole(allRoles) >  
    <cfoutput>Authenticated user is in these roles: #GetUserRoles()#</cfoutput>  
<cfelseif >  
    <cfoutput>Authenticated user is in no roles</cfoutput>  
</cfif>