IsDefined

説明

文字列値を評価して、その中で指定されている変数が存在するかどうかを調べます。

この関数は、非推奨になった ParameterExists 関数の代わりとなるものです。

戻り値

変数が見つかった場合は true、それ以外の場合は false。

カテゴリ

決定関数

関数のシンタックス

IsDefined("variable_name")

関連項目

Evaluate

履歴

ColdFusion MX: 動作が変更されました。この関数は、次の変数および構造体のみを処理できます。

  • 単純変数

  • ドット表記の名前付き変数

  • ドット表記の名前付き構造体 (例 : mystruct.key)

パラメータ

パラメータ

説明

variable_name

引用符で囲まれた文字列です。テストする変数の名前です。

使用方法

myArray[3] のような配列エントリをこの関数に渡すとエラーになります。特定のエントリが配列内に存在するかどうかをチェックするには、ArrayIsDefined 関数を使用します。

この関数または StructKeyExists 関数を使用すると、構造体内に特定のキーが存在するかどうかをテストできます。たとえば、ColdFusion が構造体として公開しているスコープを使用するときには、この関数の代わりに StructKeyExists 関数を使用できる場合もあります。次の 2 つの行は同等です。

if(isDefined("form.myVariable")) 
if(structKeyExists(form,"myVariable"))

<cfif IsDefined("form.myString")> 
    <p>The variable form.myString has been defined, so show its contents. 
    This construction allows us to place a form and its resulting action code 
    on the same page and use IsDefined to control the flow of execution.</p> 
    <p>The value of "form.myString" is <b><i> 
    <cfoutput>#form.myString#</cfoutput></i></b> 
<cfelse> 
    <p>During the first time through this template, the variable "form.myString"  
    has not yet been defined, so we do not try to evaluate it. 
</cfif> 
 
<form action="#CGI.Script_Name" method="POST"> 
<input type="Text" name="MyString" value="My sample value"> 
<input type="Submit" name=""> 
</form>