/*!
  \page lua_cpp_coroutine_page 部分的に Lua スクリプトを利用する

  C++ メインで実装を行い、一部の処理のみ Lua スクリプトで記述したい場合の実装例を紹介します。AI をスクリプトを動作させる場合や、ゲームの進行状況をスクリプトで行いたい場合に便利です。

  \n
  \section lua_cpp_coroutine_abst_section 概略

  - 初期化とコルーチンの処理関数を含んだ Lua スクリプトを luaL_dofile() で呼び出す
  - C++ 中から、コルーチンの処理関数を呼び出す
    - コルーチンを使っているのは、処理の中断と再開が容易なため

  以下に、サンプルを示します。\n
  このサンプルでは、Lua スクリプト中で数値をインクリメントしつつ表示しています。

  <a href="http://svn.sourceforge.jp/view/trunk/libs/lua/samples/partial.cpp?view=co&root=qrobosdk">partial.cpp</a>
  \include partial.cpp

  \n
  <a href="http://svn.sourceforge.jp/view/trunk/libs/lua/samples/partial.lua?view=co&root=qrobosdk">partial.lua</a>
  \include partial.lua

  \n
  実行結果
  \verbatim
% ./partial
C: 100
Lua: 0
C: 101
Lua: 1
C: 102
Lua: 2 \endverbatim

  \n
  簡単ですね。\n
  Lua で呼び出す関数が状態変数を持たないならば、コルーチンを使わず、普通の関数を使った方がよいでしょう。

  普通の関数を使ったサンプルとしては chat_client.cpp, <a href="http://svn.sourceforge.jp/view/trunk/libs/network/samples/chat_client.lua?view=co&root=qrobosdk">chat_client.lua</a> があります。(チャット用の送受信を C++ で作成し、GUI を Lua で作成)

  \n
  \section lua_cpp_coroutine_comment_section コメントページ

  - http://sourceforge.jp/forum/forum.php?forum_id=18515

  \n
*/
