CFBREAK  
説明

cfloop タグまたは cfswitch タグ内で使用します。ループまたはスイッチブロックを中断します。

 
カテゴリ

フロー制御タグ

 
シンタックス
<cfbreak>
 
関連項目

cfabort、cfexecute、cfif、cflocation、cfloop、cfswitch、cfthrow、cftry、『ColdFusion MX 開発ガイド』の第2章の「CFML の要素」 の「cfloop と cfbreak」

 
<!--- この例は、条件が満たされたときにループを終了するための cfbreak の使用方法を示します。--->
<!--- コースを選択し、cfloop を使用して条件を検索したらループを中断します。 --->
<!--- number が数値であることを確認します。 --->
<cfif IsDefined("form.course_number")>
   <cfif Not IsNumeric(form.course_number)>
      <cfabort> 
   </cfif> 
</cfif> 
<cfquery name="GetCourses" datasource="cfdocexamples">
   SELECT *
   FROM Courses
   ORDER by course_number 
</cfquery>

<p>この例では、CFLOOP を使用してクエリー全体を巡回し、値を検索します。
(この例では、Snippets データソース内の
コースに対応する値のリストとなります)。クエリーの条件が満たされたとき、CFBREAK によってループが中断され
ます。
<p>コース番号を入力し、[送信] ボタンを押してください。 
<form action="cfbreak.cfm" method="POST"> 
   <select name="courseNum"> 
      <cfoutput query="GetCourses"> 
         <option value="#course_number#">#course_number#
      </cfoutput> 
   </select> 
   <input type="Submit" name="" value="番号を検索"> 
</form> 
<!--- courseNum 変数を定義しない場合は、
      クエリー全体をループしないでください。--->
<cfif IsDefined ("form.courseNum") IS "True">
<!--- 値が見つかるまでクエリー全体をループした後、CFBREAK を使用してクエリーを終了します。--->
   <cfloop query="GetCourses"> 
      <cfif GetCourses.course_number IS form.courseNum> 
         <cfoutput> 
            <h4>希望のコースが見つかりました。</h4>
            <pre>#course_number# #descript#</pre>
         </cfoutput> 
         <cfbreak> 
      <cfelse> 
         <br>検索中... 
      </cfif> 
   </cfloop> 
</cfif>