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 の検証 の場合にのみ使用します。