ISVALID

ISVALID

説明値が検証やデータタイプのルールに準拠しているかどうかをテストします。

戻り値値がルールに準拠している場合は true、準拠していない場合は false

カテゴリ決定関数

関数のシンタックス IsValid(type, value) isValid("range", value, min, max) isValid("regex" or "regular_expression", value, pattern)

関連項目 cfparam、cfform、IsBoolean、IsDate、IsNumeric、IsSimpleValue、『ColdFusion MX 開発ガイド』の第28章の「データの検証」の「IsValid 関数および cfparam タグによるデータの検証」

ヒストリ ColdFusion MX 7: この関数が追加されました。

パラメータ

使用方法 IsValid 関数を使用することにより、検証を必ずサーバー上で実行するようにします。cfparam タグを使用して、同様に検証を実行することができます。

例次の例では、ユーザーが数値 ID および有効な電子メールアドレスと電話番号を送信したかどうかを確認します。送信された値のいずれかが検証テストの基準を満たさない場合は、エラーメッセージが表示されます。 <cfif isDefined("form.saveSubmit")> <cfif isValid("integer", form.UserID) and isValid("email", form.emailAddr) and isValid("telephone", form.phoneNo)> <cfoutput> <!--- データベースを更新するアプリケーションコードがここに入る ---> <h3>ユーザー #Form.UserID# の電子メールアドレスと電話番号が追加されました。</h3> </cfoutput> <cfelse> <H3>有効なユーザー ID、電話番号、電子メールアドレスを指定する必要があります。</H2> </cfif> <cfelse> </cfif> <cfform action="#CGI.SCRIPT_NAME#"> ユーザー ID :<cfinput type="Text" name="UserID"><br> 電話番号 :<cfinput type="Text" name="phoneNo"><br> 電子メール :<cfinput type="Text" name="emailAddr"><br> <cfinput type="submit" name="saveSubmit" value="Save Data"><br> </cfform>

type 有効なデータの形式です。次のいずれかです。検証アルゴリズムに関する情報の詳細については、『ColdFusion MX 開発ガイド』の第28章の「データの検証」の「非表示フィールドによるフォームデータの検証」を参照してください。

any: 任意の単純値です。クエリーオブジェクトなどの複雑な値の場合は false を返します。IsSimpleValue 関数と同様です。
array: ColdFusion 配列です。IsArray 関数と同様です。
binary: バイナリ値です。IsBinary 関数と同様です。
boolean: ブール値 (yes、no、true、false、または数値) です。IsBoolean 関数と同様です。
creditcard: mod10 アルゴリズムに準拠する 13 ～ 16 桁の数値です。
date または time: 日付と時刻を含む、任意の日付時刻値です。IsDate 関数と同様です。
email: 有効な電子メールアドレスです。
eurodate: 米国の日付形式と時刻を含む、任意の日付時刻値です。
float または numeric: 数値です。IsNumeric 関数と同様です。
guid: Universally Unique Identifier (ユニバーサル固有識別子) です。形式は "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" で、"X" は 16 進数です。
integer: 整数です。
query: クエリーオブジェクトです。IsQuery 関数と同様です。
range: 数値の範囲です。min 属性と max 属性で指定します。
regex または regular_expression: 入力内容を pattern 属性と照合します。
ssn または social_security_number: 米国の社会保障番号です。
string: シングルバイトの文字と数字で構成された文字列値です。
struct: 構造体です。IsStruct 関数と同様です。
telephone: 米国の標準の電話番号です。
URL: http、https、ftp、file、mailto、または news の URL です。
UUID: ColdFusion Universally Unique Identifier (ユニバーサル固有識別子) です。形式は "XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXX" で、"X" は 16 進数です。CreateUUIDを参照してください。
USdate: mm/dd/yy の書式を使用する US 日付 (1 ～ 2 桁の月と日、1 ～ 4 桁の年を使用) です。
variableName: ColdFusion 変数のネーミング規則に従った形式の文字列です。
zipcode: 米国の 5 桁または 9 桁形式の郵便番号です。

value テスト対象の値です。 min 最小有効値です。range の検証の場合にのみ使用します。 max 最大有効値です。range の検証の場合にのみ使用します。 pattern パラメータ表記の基準となる JavaScript 正規表現です。regex または regular_expression の検証の場合にのみ使用します。