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 開発ガイド』のデータの検証のIsValid 関数および cfparam タグによるデータの検証

ヒストリ

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

パラメータ

パラメータ 説明

type

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

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

使用方法

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>

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX* | ColdFusion 5* | フォーラム* | デベロッパーセンター | サポート情報 | バグ報告

バージョン7