`validatesExclusionOf()`

Description

Validates that the value of the specified property does not exist in the supplied list.

Function Syntax

validatesExclusionOf([ properties, list, message, when, allowBlank, if, unless ])

Parameters

Parameter	Type	Required	Default	Description
`properties`	`string`	No		Name of property or list of property names to validate against (can also be called with the `property` argument).
`list`	`string`	Yes		Single value or list of values that should not be allowed.
`message`	`string`	No	`[property] is reserved`	Supply a custom error message here to override the built-in one.
`when`	`string`	No	`onSave`	Pass in `onCreate` or `onUpdate` to limit when this validation occurs (by default validation will occur on both create and update, i.e. `onSave`).
`allowBlank`	`boolean`	No	`false`	If set to `true`, validation will be skipped if the property value is an empty string or doesn't exist at all.
`if`	`string`	No		String expression to be evaluated that decides if validation will be run (if the expression returns `true` validation will run).
`unless`	`string`	No		String expression to be evaluated that decides if validation will be run (if the expression returns `false` validation will run).

Examples

<!--- Do not allow "PHP" or "Fortran" to be saved to the database as a cool language --->
<cfset validatesExclusionOf(property="coolLanguage", list="php,fortran", message="Haha, you can not be serious, try again please.")>