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>