/* -*- Indented-Text -*- */
-/* Copyright (C) 2003, 2010 TSUTSUMI Kikuo.
+/* Copyright (C) 2003, 2010, 2013 TSUTSUMI Kikuo.
This file is part of the CCUnit Library.
The CCUnit Library is free software; you can redistribute it and/or
@english
@page cookbook CCUnit Cookbook
@japanese
-@page cookbook CCUnit ¥¯¥Ã¥¯¥Ö¥Ã¥¯
+@page cookbook CCUnit ã\82¯ã\83\83ã\82¯ã\83\96ã\83\83ã\82¯
@endif
@~english
Here is a short cookbook to help you get started.
@~japanese
-¤³¤ì¤Ï CCUnit ¤ò»È¤¤»Ï¤á¤ë¤Ë¤¢¤¿¤Ã¤Æ¡¢
-Íý²ò¤Î½õ¤±¤È¤Ê¤ë¤è¤¦¤Êû¤¤¥¯¥Ã¥¯¥Ö¥Ã¥¯¤Ç¤¹¡£
+これは CCUnit を使い始めるにあたって、
+理解の助けとなるような短いクックブックです。
@~
@english
[see also <a href="../ja/cookbook.html">Japanese</a> documents]
@english
@section simple_test_case Simple Test Case
@japanese
-@section simple_test_case ¥·¥ó¥×¥ë¤Ê¥Æ¥¹¥È¥±¡¼¥¹
+@section simple_test_case ã\82·ã\83³ã\83\97ã\83«ã\81ªã\83\86ã\82¹ã\83\88ã\82±ã\83¼ã\82¹
@endif
@english
always there to help you keep confidence in the quality of
your code.
@japanese
-<b>CCUnit</b> ¤ò»È¤Ã¤¿¥Æ¥¹¥È¤Ï¼«Æ°Åª¤Ë¼Â¹Ô¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
-CCUnit ¤Î¥Æ¥¹¥È¤Ï´Êñ¤Ë¥»¥Ã¥È¥¢¥Ã¥×¤¹¤ë¤³¤È¤¬¤Ç¤¡¢
-°ìÅ٥ƥ¹¥È¤ò½ñ¤¤¤Æ¤·¤Þ¤¨¤Ð¡¢
-¤¤¤Ä¤Ç¤â¥×¥í¥°¥é¥à¤ÎÉʼÁ¤ò¿®Íê¤Ç¤¤ë¤â¤Î¤ËÊݤĤ³¤È¤¬¤Ç¤¤ë¤Ç¤·¤ç¤¦¡£
+<b>CCUnit</b> を使ったテストは自動的に実行することができます。
+CCUnit のテストは簡単にセットアップすることができ、
+一度テストを書いてしまえば、
+いつでもプログラムの品質を信頼できるものに保つことができるでしょう。
@endif
@english
To make a simple test, here is what you do:
@japanese
-´Êñ¤Ê¥Æ¥¹¥È¤òºî¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+簡単なテストを作るには、次のようにします。
@endif
<ol>
<li> @english Create a test function
- @japanese ¥Æ¥¹¥È´Ø¿ô¤òºî¤ê¤Þ¤¹¡£
+ @japanese テスト関数を作ります。
@endif
</li>
<li> @english When you want to check a value, call
ASSERT macro is listed in others as well in
@link Assertions Assert Macros@endlink.
@japanese
- Ãͤò¥Á¥§¥Ã¥¯¤·¤¿¤¤¾ì¹ç¤Ï¡¢
+ 値をチェックしたい場合は、
@link CCUNIT_ASSERT(bool) @endlink
- ¤ò¸Æ¤Ó½Ð¤·¤Æ¡¢
- ¥Æ¥¹¥È¤¬À®¸ù¤¹¤ë¤Ê¤é¿¿¤òÊÖ¤¹¤è¤¦¤Ê¿¿µ¶ÃͤòÅϤ·¤Þ¤¹¡£
+ を呼び出して、
+ テストが成功するなら真を返すような真偽値を渡します。
- ASSERT ´Ø·¸¤Î¥Þ¥¯¥í¤Ï¾¤Ë¤â
- @link Assertions ASSERT ¥Þ¥¯¥í@endlink¤Ë¥ê¥¹¥È¤·¤Æ¤¢¤ê¤Þ¤¹¡£
+ ASSERT 関係のマクロは他にも
+ @link Assertions ASSERT マクロ@endlinkにリストしてあります。
@endif
</li>
</ol>
To test whether the initialization of the complex numeber
and tow complex numbers are equal.
@japanese
-Î㤨¤Ð¡¢´Êñ¤ÊÊ£ÁÇ¿ô¤Î¥é¥¤¥Ö¥é¥ê¤Î¥Æ¥¹¥È¤òÎã¤Ë¤È¤Ã¤Æ¤ß¤Þ¤·¤ç¤¦¡£
-¡Ê¤³¤³¤Ç»ÈÍѤ¹¤ë@ref sample_programs ¤Ï
-@c examples/complex ¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤¢¤ê¤Þ¤¹¡£¡Ë
-Ê£ÁÇ¿ô¤ò½é´ü²½¤¹¤ë¤³¤È¤¬¤Ç¤¤¿¤«¤ò¥Æ¥¹¥È¤·¤¿¤ê¡¢
-Æó¤Ä¤ÎÊ£ÁÇ¿ô¤¬Åù¤·¤¤¤«¤ò¥Æ¥¹¥È¤·¤¿¤ê¤·¤Þ¤¹¡£
+例えば、簡単な複素数のライブラリのテストを例にとってみましょう。
+(ここで使用する@ref sample_programs は
+@c examples/complex ディレクトリにあります。)
+複素数を初期化することができたかをテストしたり、
+二つの複素数が等しいかをテストしたりします。
@endif
@dontinclude complex/testComplex.c
These two test functions are made one test case together,
and we can run it.
@japanese
-¤³¤ÎÆó¤Ä¤Î¥Æ¥¹¥È´Ø¿ô¤ò¤Þ¤È¤á¤Æ¤Ò¤È¤Ä¤Î¥Æ¥¹¥È¥±¡¼¥¹¤Ë¤·¤Æ¼Â¹Ô¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
+この二つのテスト関数をまとめてひとつのテストケースにして実行することができます。
@endif
@dontinclude complex/runTestCase.c
@english
Include the necessary header files.
@japanese
-ɬÍפʥإåÀ¥Õ¥¡¥¤¥ë¤ò¥¤¥ó¥¯¥ë¡¼¥É¤·¤Þ¤¹¡£
+必要なヘッダファイルをインクルードします。
@endif
@skip CCUnitTestCase.h
@english
First, Allocate the test case memory.
@japanese
-¤Þ¤º¥Æ¥¹¥È¥±¡¼¥¹¤Ë¥á¥â¥ê¤ò³ä¤êÅö¤Æ¤Þ¤¹¡£
+まずテストケースにメモリを割り当てます。
@endif
@until main
and the explanation of the function
to indicate it at the unsuccessful time.
@japanese
-¤½¤·¤Æ¥Æ¥¹¥È¥±¡¼¥¹¤Ë¥Æ¥¹¥È´Ø¿ô¤òÅÐÏ¿¤·¤Þ¤¹¡£
-ɽÌÀ (ASSERT) ¤¬¼ºÇÔ¤·¤¿»þ¤Ëɽ¼¨¤¹¤ë¤¿¤á¤Î´Ø¿ô̾¤È´Ø¿ô¤ÎÀâÌÀ¤ò°ì½ï¤Ë»ØÄꤷ¤Æ¤¤¤Þ¤¹¡£
+そしてテストケースにテスト関数を登録します。
+表明 (ASSERT) が失敗した時に表示するための関数名と関数の説明を一緒に指定しています。
@endif
@until test_complex_equals);
@english
Run the test case, and take out the result.
@japanese
-¥Æ¥¹¥È¥±¡¼¥¹¤ò¼Â¹Ô¤·¡¢
-·ë²Ì¤ò¼è¤ê½Ð¤·¤Þ¤¹¡£
+テストケースを実行し、
+結果を取り出します。
@endif
@until wasSuccessful
Deallocate the memory whitch you assigned,
and return the result.
@japanese
-³ä¤êÅö¤Æ¤¿¥á¥â¥ê¤ò²òÊü¤·¡¢
-·ë²Ì¤òÊÖ¤·¤Þ¤¹¡£
+割り当てたメモリを解放し、
+結果を返します。
@endif
@until }
To compile and run, do the following:
@japanese
-¤³¤³¤Þ¤Ç¤Î¥µ¥ó¥×¥ë¥³¡¼¥É¤Ï¡¢@c examples/complex ¥Ç¥£¥ì¥¯¥È¥ê¤Î
-<code>testComplex.c, runTestCase.c</code> ¤Ë¤¢¤ê¤Þ¤¹¡£
+ここまでのサンプルコードは、@c examples/complex ディレクトリの
+<code>testComplex.c, runTestCase.c</code> にあります。
-¥³¥ó¥Ñ¥¤¥ë¤ª¤è¤Ó¼Â¹Ô¤¹¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+コンパイルおよび実行するには、次のようにします。
@endif
@code
no diagnostics will be displayed. One will normally use a
@ref ExecutingTest to display the results.
@japanese
-¥Æ¥¹¥È¥±¡¼¥¹¤¬¼Â¹Ô¤µ¤ì¤ë¤È¡¢
-»ØÄꤷ¤¿¥Æ¥¹¥È´Ø¿ô¤¬¸Æ¤Ó½Ð¤µ¤ì¤Þ¤¹¡£
-¤³¤ì¤Ï¤Þ¤À¤¢¤Þ¤êÊØÍø¤Ç¤Ï¤¢¤ê¤Þ¤»¤ó¡¢
-¤Ê¤¼¤Ê¤é¡¢¿ÇÃǤ¬É½¼¨¤µ¤ì¤Ê¤¤¤«¤é¤Ç¤¹¡£
-Ä̾ï¤Ï@ref ExecutingTest ¤Ç·ë²Ì¤òɽ¼¨¤·¤Þ¤¹¡£
+テストケースが実行されると、
+指定したテスト関数が呼び出されます。
+これはまだあまり便利ではありません、
+なぜなら、診断が表示されないからです。
+通常は@ref ExecutingTest で結果を表示します。
@endif
@english
@section test_runner TestRunner
@japanese
-@section test_runner ¥Æ¥¹¥È¥é¥ó¥Ê¡¼
+@section test_runner ã\83\86ã\82¹ã\83\88ã\83©ã\83³ã\83\8aã\83¼
@endif
@english
@link CCUnitTestRunner TestRunner@endlink
of the executive conditionsn of the test.
@japanese
-¥Æ¥¹¥È¤ò¼Â¹Ô¤·¤¿¤È¤¤Ë¡¢¤É¤¦¤ä¤Ã¤Æ¤½¤Î·ë²Ì¤ò½¸¤á¤¿¤éÎɤ¤¤Ç¤·¤ç¤¦¤«¡£
-¥Æ¥¹¥È¥±¡¼¥¹¤Ï¥Æ¥¹¥È´Ø¿ô¤Î¼Â¹Ô·ë²Ì
-@link CCUnitTestFailure TestFailure @endlink ¤ò
-@link CCUnitTestResult TestResult @endlink ¤Ë³ÊǼ¤·¤Þ¤¹¡£
-Ʊ»þ¤Ë¥Æ¥¹¥È¤Î¼Â¹Ô¾õ¶·¤ò @link CCUnitTestRunner TestRunner @endlink
-¤ËÄÌÃΤ·¤Þ¤¹¡£
+テストを実行したときに、どうやってその結果を集めたら良いでしょうか。
+テストケースはテスト関数の実行結果
+@link CCUnitTestFailure TestFailure @endlink を
+@link CCUnitTestResult TestResult @endlink に格納します。
+同時にテストの実行状況を @link CCUnitTestRunner TestRunner @endlink
+に通知します。
@endif
@dot
to define the suite to be run and to display
its results.
@japanese
-°ì¤Ä¥Æ¥¹¥È¥±¡¼¥¹¤ò½ñ¤¤¤¿¤é¡¢
-¤½¤ì¤ò¼Â¹Ô¤·¤¿¤¤¤È»×¤¦¤Ç¤·¤ç¤¦¡£
-CCUnit ¤Î @link ExecutingTest TestRunner @endlink ¤Ï¡¢
-¥Æ¥¹¥È¥±¡¼¥¹¤ò¥Æ¥¹¥È¥¹¡¼¥Ä¤Ë¤Þ¤È¤á¤Æ¼Â¹Ô¤··ë²Ì¤òɽ¼¨¤·¤Þ¤¹¡£
+一つテストケースを書いたら、
+それを実行したいと思うでしょう。
+CCUnit の @link ExecutingTest TestRunner @endlink は、
+テストケースをテストスーツにまとめて実行し結果を表示します。
@endif
@english
To use the @link CCUnitTestRunner TestRunner@endlink,
include the header files for the tests in <code>runTestCaseRunner.c</code>:
@japanese
-@link CCUnitTestRunner TestRunner @endlink ¤ò»ÈÍѤ¹¤ë¤Ë¤Ï¡¢
-Î㤨¤Ð @c runTestCaseRunner.c ¤Ç¥Æ¥¹¥È¤Î¤¿¤á¤Î¥Õ¥¡¥¤¥ë¤Î¥Ø¥Ã¥À¤ò¥¤¥ó¥¯¥ë¡¼¥É¤·¤Þ¤¹¡£
+@link CCUnitTestRunner TestRunner @endlink を使用するには、
+例えば @c runTestCaseRunner.c でテストのためのファイルのヘッダをインクルードします。
@endif
@dontinclude complex/runTestCaseRunner.c
First, make the @link CCUnitTestSuite TestSuite@endlink,
and register the @link CCUnitTestCase TestCase@endlink.
@japanese
-¤Þ¤º @link CCUnitTestSuite TestSuite@endlink ¤òºîÀ®¤·¡¢
-¤½¤ì¤Ë @link CCUnitTestCase TestCase@endlink ¤òÅÐÏ¿¤·¤Þ¤¹¡£
+まず @link CCUnitTestSuite TestSuite@endlink を作成し、
+それに @link CCUnitTestCase TestCase@endlink を登録します。
@endif
@until ccunit_addTestCase
And call to
@link ccunit_runTestRunner(CCUnitTestRunner*, CCUnitTestSuite *)@endlink:
@japanese
-¤½¤·¤Æ @link ccunit_runTestRunner(CCUnitTestRunner*, CCUnitTestSuite *) @endlink
-¤ò¼Â¹Ô¤·¤Þ¤¹¡£
+そして @link ccunit_runTestRunner(CCUnitTestRunner*, CCUnitTestSuite *) @endlink
+を実行します。
@endif
@until runTestRunner
@english
Deallocate the memories.
@japanese
-³ä¤êÅö¤Æ¤¿¥á¥â¥ê¤ò²òÊü¤·¤Þ¤¹¡£
-¤¿¤À¤·¡¢@c testCase ¤Ï @c suite ¤ËÅÐÏ¿¤·¤Æ¤¢¤ë¤Î¤Ç¡¢
-@c suite ¤ò²òÊü¤¹¤ë»þ¤Ë°ì½ï¤Ë²òÊü¤µ¤ì¤Þ¤¹¡£
-¤½¤Î¤¿¤á @c testCase ¤Ï¤³¤³¤Ç²òÊü¤¹¤ëɬÍפ¬¤¢¤ê¤Þ¤»¤ó¡£
-²òÊü¤·¤è¤¦¤È¤¹¤ë¤È Bus error ¤Ê¤É¤Ë¤Ê¤ê¤Þ¤¹¤Î¤ÇÃí°Õ¤·¤Æ¤¯¤À¤µ¤¤¡£
+割り当てたメモリを解放します。
+ただし、@c testCase は @c suite に登録してあるので、
+@c suite を解放する時に一緒に解放されます。
+そのため @c testCase はここで解放する必要がありません。
+解放しようとすると Bus error などになりますので注意してください。
@endif
@until }
To compile and run, do the following:
@japanese
-¤³¤³¤Þ¤Ç¤Î¥µ¥ó¥×¥ë¥³¡¼¥É¤Ï¡¢<code>examples/complex</code> ¥Ç¥£¥ì¥¯¥È¥ê¤Î
+ここまでのサンプルコードは、<code>examples/complex</code> ディレクトリの
<code>runTestCaseRunner.c</code>
-¤Ë¤¢¤ê¤Þ¤¹¡£
+にあります。
-¥³¥ó¥Ñ¥¤¥ë¤ª¤è¤Ó¼Â¹Ô¤¹¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+コンパイルおよび実行するには、次のようにします。
@endif
@code
If all the tests pass, you'll get an informative message.
If any fail, you'll get the following information:
@japanese
-@link ExecutingTest TestRunner @endlink ¤Ï¥Æ¥¹¥È¤ò¼Â¹Ô¤·¤Þ¤¹¡£
-¤â¤·¤¹¤Ù¤Æ¤Î¥Æ¥¹¥È¤¬¥Ñ¥¹¤¹¤ì¤Ð¡¢¤½¤Î¾ðÊó¤Î¥á¥Ã¥»¡¼¥¸¤¬É½¼¨¤µ¤ì¤Þ¤¹¡£
-¾å¤ÎÎã¤Ç¤Ï¡¢ºÇ½é¤Î¡Ö<code>..</code>¡×¤Ï¼Â¹Ô¤·¤¿¥Æ¥¹¥È¥±¡¼¥¹¤Ç¤¹¡£
-¼Â¹Ô¤¹¤ëľÁ°¤Ë¡Ö<code>.</code>¡×¤¬½ÐÎϤµ¤ì¤Þ¤¹¡£
-Á´¤Æ¤Î¥Æ¥¹¥È¥±¡¼¥¹¤Î¼Â¹Ô¤¬½ªÎ»¤¹¤ë¤È¡¢
-¼Â¹Ô¤Ë¤«¤«¤Ã¤¿»þ´Ö¤È¼Â¹Ô¤·¤¿¥Æ¥¹¥È¥±¡¼¥¹¤Î¿ô¤¬É½¼¨¤µ¤ì¤Þ¤¹¡£
+@link ExecutingTest TestRunner @endlink はテストを実行します。
+もしすべてのテストがパスすれば、その情報のメッセージが表示されます。
+上の例では、最初の「<code>..</code>」は実行したテストケースです。
+実行する直前に「<code>.</code>」が出力されます。
+全てのテストケースの実行が終了すると、
+実行にかかった時間と実行したテストケースの数が表示されます。
-¤É¤ì¤«¤¬¼ºÇÔ¤¹¤ì¤Ð¡¢¤½¤ì¤Ë¤Ä¤¤¤Æ°Ê²¼¤Î¤è¤¦¤Ê¾ðÊó¤¬É½¼¨¤µ¤ì¤Þ¤¹¡£
+どれかが失敗すれば、それについて以下のような情報が表示されます。
@endif
<ul>
<li>@english
The name of the source file that contains the test
@japanese
- ¥Æ¥¹¥È¤ò´Þ¤ó¤Ç¤¤¤ë¥½¡¼¥¹¥Õ¥¡¥¤¥ë̾
+ テストを含んでいるソースファイル名
@endif
</li>
<li>@english
The line number where the failure occurred
@japanese
- ¼ºÇÔ¤¬µ¯¤³¤Ã¤¿¹ÔÈÖ¹æ
+ 失敗が起こった行番号
@endif
</li>
<li>@english
The name of the test case that failed
@japanese
- ¼ºÇÔ¤·¤¿¥Æ¥¹¥È¥±¡¼¥¹¤Î̾Á°
+ 失敗したテストケースの名前
@endif
</li>
<li>@english
All of the text inside the call to
@link CCUNIT_ASSERT(bool)@endlink which detected the failure
@japanese
- ¼ºÇÔ¤ò¸¡ÃΤ·¤¿ @link CCUNIT_ASSERT(bool)@endlink ¤¬¸Æ¤Ó½Ð¤µ¤ì¤¿»þ¤Î¾ò·ï¤Îʸ»úÎó¡£
+ 失敗を検知した @link CCUNIT_ASSERT(bool)@endlink が呼び出された時の条件の文字列。
@endif
</li>
</ul>
For example, try to mistake it in the test case
of @c testComplex.c on purpose.
@japanese
-»î¤·¤Ë @c testComplex.c ¤Î¥Æ¥¹¥È¥±¡¼¥¹¤Ç¤ï¤¶¤È´Ö°ã¤¨¤Æ¤ß¤Þ¤·¤ç¤¦¡£
+試しに @c testComplex.c のテストケースでわざと間違えてみましょう。
@endif
@code
In this example, two test cases are run.
Then, you will see that the second is unsuccessful.
@japanese
-¤³¤ÎÎã¤Ç¤Ï¥Æ¥¹¥È¥±¡¼¥¹¤ò 2 ¸Ä¼Â¹Ô¤·¤Æ¡¢
-¤Ò¤È¤Ä¤Î¥Æ¥¹¥È¥±¡¼¥¹¤Ç¼ºÇÔ¤·¤Æ¤¤¤ë¤³¤È¤¬¤ï¤«¤ê¤Þ¤¹¡£
-ºÇ½é¤Î¡Ö <code>.F.</code>¡×¤Ç¤Ï¡¢
-¤Ò¤È¤ÄÌܤΥƥ¹¥È¥±¡¼¥¹¤¬¼ºÇÔ¤·¤Æ¤¤¤ë¤³¤È¤ò¤¢¤é¤ï¤·¤Æ¤¤¤Þ¤¹¡£
+この例ではテストケースを 2 個実行して、
+ひとつのテストケースで失敗していることがわかります。
+最初の「 <code>.F.</code>」では、
+ひとつ目のテストケースが失敗していることをあらわしています。
-¤Þ¤¿¾å½Ò¤Î¤è¤¦¤Ë¡¢
-¼ºÇÔ¤·¤¿¥Õ¥¡¥¤¥ë̾¡¢¹ÔÈֹ桢¥Æ¥¹¥È¥±¡¼¥¹¤Î̾Á° (<code>complex new test</code>)¡¢
-ɽÌÀ¤·¤¿¾ò·ï¤Îʸ»úÎó (<code>1.1 == c10_1->imaginary</code>) ¤¬É½¼¨¤µ¤ì¤Þ¤¹¡£
+また上述のように、
+失敗したファイル名、行番号、テストケースの名前 (<code>complex new test</code>)、
+表明した条件の文字列 (<code>1.1 == c10_1->imaginary</code>) が表示されます。
@endif
@english
little test cases that you'll want to run on the same set of
objects. To do this, use global variables.
@japanese
-¤³¤ì¤ÏÂçÊÑñ½ã¤Ê¥Æ¥¹¥È¤Ç¤¹¡£
-Ä̾
-¤¿¤¯¤µ¤ó¤Î¾®¤µ¤Ê¥Æ¥¹¥È´Ø¿ô¤òºî¤Ã¤Æ¡¢
-Ʊ¤¸¤è¤¦¤Ê¥Ç¡¼¥¿¤Î½¸¤Þ¤ê¤ò»È¤Ã¤Æ¥Æ¥¹¥È¤ò¹Ô¤¦¤Ç¤·¤ç¤¦¡£
-¤Ä¤Þ¤ê³Æ¥Æ¥¹¥È´Ø¿ô¶¦Ä̤Υ°¥í¡¼¥Ð¥ëÊÑ¿ô¤ò»È¤¦¤³¤È¤Ë¤Ê¤ê¤Þ¤¹¡£
+これは大変単純なテストです。
+通常、
+たくさんの小さなテスト関数を作って、
+同じようなデータの集まりを使ってテストを行うでしょう。
+つまり各テスト関数共通のグローバル変数を使うことになります。
@endif
@english
@section setUp_and_tearDown setUp and tearDown
@japanese
-@section setUp_and_tearDown setUp ¤È tearDown
+@section setUp_and_tearDown setUp と tearDown
@endif
@english
What if you have two or more tests that operate on the same
similar set of objects?
@japanese
-¤â¤·Ê£¿ô¤Î¥Æ¥¹¥È´Ø¿ô¤¬¤¢¤ë¤Ê¤é¡¢
-Ʊ¤¸¥Ç¡¼¥¿¤Î½¸¤Þ¤ê¤ò¤¤¤¯¤Ä¤«»È¤¦¤Î¤Ç¤Ï¤Ê¤¤¤Ç¤·¤ç¤¦¤«¡£
+もし複数のテスト関数があるなら、
+同じデータの集まりをいくつか使うのではないでしょうか。
@endif
@dot
more time writing the code to set up the data than you do
in actually testing values.
@japanese
-¥Æ¥¹¥È¤ÏÃæ¿È¤Î¤ï¤«¤Ã¤Æ¤¤¤ë¥Ç¡¼¥¿¤Î½¸¤Þ¤ê¤òÁ°Äó¤È¤·¤Æ¼Â¹Ô¤µ¤ì¤ëɬÍפ¬¤¢¤ê¤Þ¤¹¡£
-¥Æ¥¹¥È¤ò½ñ¤¤¤Æ¤¤¤ë¤È¡¢
-¼ÂºÝ¤Ë¥Æ¥¹¥È¤¹¤ë¥³¡¼¥É¤è¤ê¤â¡¢
-Ãͤò¥»¥Ã¥È¥¢¥Ã¥×¤¹¤ë¥³¡¼¥É¤ò½ñ¤¯Êý¤Ë¡¢
-¤è¤ê»þ´Ö¤ò¤«¤±¤Æ¤¤¤ë¤³¤È¤¬¤è¤¯¤¢¤ê¤Þ¤¹¡£
+テストは中身のわかっているデータの集まりを前提として実行される必要があります。
+テストを書いていると、
+実際にテストするコードよりも、
+値をセットアップするコードを書く方に、
+より時間をかけていることがよくあります。
@endif
@english
some complex numbers are allocated,
and it is deleted.
@japanese
-Î㤨¤ÐÁ°Àá¤Î¥µ¥ó¥×¥ë¥³¡¼¥É¤Ç¤Ï¡¢
-¤¤¤¯¤Ä¤«¤ÎÊ£ÁÇ¿ô¤ò³ä¤êÅö¤Æ¤¿¤ê²òÊü¤·¤¿¤ê¤·¤Æ¤¤¤Þ¤¹¡£
+例えば前節のサンプルコードでは、
+いくつかの複素数を割り当てたり解放したりしています。
@endif
@english
Then, if the test is finished, clean-up the data.
The function @c setUp and @c tearDown are used at such time.
@japanese
-¿¤¯¤Î¾ì¹ç¡¢¤¤¤¯¤Ä¤«¤Î°Û¤Ê¤Ã¤¿¥Æ¥¹¥È¤Î¤¿¤á¤ËƱ¤¸¥°¥í¡¼¥Ð¥ëÊÑ¿ô¤ò»È¤¦¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
-¤½¤ì¤¾¤ì¤Î¥Æ¥¹¥È´Ø¿ô¤ò¼Â¹Ô¤¹¤ëÁ°¤ËÊÑ¿ô¤ò½é´ü²½¤·¡¢
-ÃͤòÄ´¤Ù¤ë¤³¤È¤Ë¤Ê¤ë¤Ç¤·¤ç¤¦¡£
-¤½¤·¤Æ¥Æ¥¹¥È¤¬½ª¤ï¤Ã¤¿¤é¸å»ÏËö¤¹¤ë¤³¤È¤Ë¤Ê¤ê¤Þ¤¹¡£
+多くの場合、いくつかの異なったテストのために同じグローバル変数を使うことができます。
+それぞれのテスト関数を実行する前に変数を初期化し、
+値を調べることになるでしょう。
+そしてテストが終わったら後始末することになります。
-@c setUp ¤È @c tearDown ´Ø¿ô¤Ï¤½¤Î¤è¤¦¤Ê¾ì¹ç¤Ë»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
+@c setUp と @c tearDown 関数はそのような場合に使用することができます。
@endif
@dot
@english
When you have a common global variables, here is what you do:
@japanese
-¤â¤·³Æ¥Æ¥¹¥È¤Ë¶¦Ä̤Υ°¥í¡¼¥Ð¥ëÊÑ¿ô¤¬¤¢¤ì¤Ð¡¢
-¼¡¤Î¤è¤¦¤Ë¤¹¤ë¤³¤È¤Ë¤Ê¤ê¤Þ¤¹¡£
+もし各テストに共通のグローバル変数があれば、
+次のようにすることになります。
@endif
@dontinclude complex/testComplexSetup.c
@english
Define the global variable.
@japanese
-¥°¥í¡¼¥Ð¥ëÊÑ¿ô¤òÄêµÁ¤·¤Þ¤¹¡£
+グローバル変数を定義します。
@endif
@skipline complex.h
@english
Write the function @c setUp to allocate the complex.
@japanese
-Ê£ÁÇ¿ô¤ò³ä¤êÅö¤Æ¤ë @c setUp ´Ø¿ô¤ò½ñ¤¤Þ¤¹¡£
+複素数を割り当てる @c setUp 関数を書きます。
@endif
@until }
@english
Write the function @c tearDown to delete the memory of that complex.
@japanese
-³ä¤êÅö¤Æ¤¿¥á¥â¥ê¤ò²òÊü¤¹¤ë @c tearDown ´Ø¿ô¤ò½ñ¤¤Þ¤¹¡£
+割り当てたメモリを解放する @c tearDown 関数を書きます。
@endif
@until }
@english
Write the test function.
@japanese
-¥Æ¥¹¥È´Ø¿ô¤ò½ñ¤¤Þ¤¹¡£
+テスト関数を書きます。
@endif
@until test_complex_equals
At this time, the name of the function must have begun with
@c "setUp" or @c "tearDown".
@japanese
-@c setUp ¤È @c tearDown ¤òÅÐÏ¿¤·¤Þ¤¹¡£
-¤³¤Î»þ¡¢´Ø¿ô¤Î̾Á°¤¬ @c setUp/tearDown ¤Ç»Ï¤Þ¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤ê¤Þ¤»¤ó¡£
+@c setUp と @c tearDown を登録します。
+この時、関数の名前が @c setUp/tearDown で始まっていなければなりません。
@endif
@dontinclude complex/runTestCaseSetup.c
@english
Run the test case, and return the result.
@japanese
-¥Æ¥¹¥È¥±¡¼¥¹¤ò¼Â¹Ô¤·¡¢
-·ë²Ì¤òÊÖ¤·¤Þ¤¹¡£
+テストケースを実行し、
+結果を返します。
@endif
@until }
To compile and run, do the following:
@japanese
-¤³¤³¤Þ¤Ç¤Î¥µ¥ó¥×¥ë¥³¡¼¥É¤Ï¡¢@c examples/complex ¥Ç¥£¥ì¥¯¥È¥ê¤Î
-<code>testComplexSetup.c, runTestCaseSetup.c</code> ¤Ë¤¢¤ê¤Þ¤¹¡£
+ここまでのサンプルコードは、@c examples/complex ディレクトリの
+<code>testComplexSetup.c, runTestCaseSetup.c</code> にあります。
-¥³¥ó¥Ñ¥¤¥ë¤ª¤è¤Ó¼Â¹Ô¤¹¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+コンパイルおよび実行するには、次のようにします。
@endif
@code
@english
@section one_time_setUp_tearDown setUp/tearDown of only one time
@japanese
-@section one_time_setUp_tearDown °ì²ó¤À¤±¤Î setUp/tearDown
+@section one_time_setUp_tearDown 一回だけの setUp/tearDown
@endif
@english
You register the @c setUp and @c tearDown function in the test case for that.
Then, the test functions are run in the following order:
@japanese
-Á°¤ÎÀá¤Ç¤Ï¥Æ¥¹¥È¤´¤È¤ËËè²ó½é´ü²½¤ò¹Ô¤Ã¤Æ¤¤¤Þ¤·¤¿¡£
-¤·¤«¤·¡¢
-°ì²ó¤À¤±½é´ü²½¤ò¹Ô¤Ã¤Æ¡¢
-Ê£¿ô¤Î¥Æ¥¹¥È¤ò¼Â¹Ô¤·¤¿¤¤¾ì¹ç¤¬¤¢¤ê¤Þ¤¹¡£
-¤½¤·¤Æ¥Æ¥¹¥È¤¬Á´¤Æ½ª¤ï¤Ã¤¿¤È¤¤À¤±¸å»ÏËö¤Î¥³¡¼¥É¤ò¼Â¹Ô¤¹¤ë¤è¤¦¤Ê¾ì¹ç¤¬¤¢¤ê¤Þ¤¹¡£
+前の節ではテストごとに毎回初期化を行っていました。
+しかし、
+一回だけ初期化を行って、
+複数のテストを実行したい場合があります。
+そしてテストが全て終わったときだけ後始末のコードを実行するような場合があります。
-¤½¤Î¤¿¤á¤Ë¤Ï¥Æ¥¹¥È¥±¡¼¥¹¤Ë
-@c setUpBeforeClass, @c tearDownAfterClass ´Ø¿ô¤òÅÐÏ¿¤·¤Þ¤¹¡£
-¤¹¤ë¤È¼¡¤Î¤è¤¦¤Ê½ç½ø¤Ç¥Æ¥¹¥È´Ø¿ô¤¬¼Â¹Ô¤µ¤ì¤Þ¤¹¡£
+そのためにはテストケースに
+@c setUpBeforeClass, @c tearDownAfterClass 関数を登録します。
+すると次のような順序でテスト関数が実行されます。
@endif
@dot
@english
@section suite Suite
@japanese
-@section suite ¥¹¡¼¥Ä
+@section suite スーツ
@endif
@english
How do you set up your tests so that you can run them all at once?
Once you have several tests, organize them into a suite.
@japanese
-Ê£¿ô¤Î¥Æ¥¹¥È¤òÁ´Éô°ìÅ٤˼¹Ԥ¹¤ë¤³¤È¤¬¤Ç¤¤ë¤è¤¦¤Ë½àÈ÷¤¹¤ë¤Ë¤Ï¡¢
-¤É¤Î¤è¤¦¤Ë¤·¤¿¤é¤¤¤¤¤Ç¤·¤ç¤¦¤«¡©
-¤¤¤¯¤Ä¤«¤Î¥Æ¥¹¥È¤òºî¤Ã¤¿¤é¡¢
-¤½¤ì¤é¤ò¥¹¡¼¥Ä¤ËÀ°Íý¤·¤Þ¤¹¡£
+複数のテストを全部一度に実行することができるように準備するには、
+どのようにしたらいいでしょうか?
+いくつかのテストを作ったら、
+それらをスーツに整理します。
@endif
@dot
module that runs any number of TestFuncs together.
You saw, above, how to run test suite.
@japanese
-CCUnit ¤Ï¤¤¤¯¤Ä¤â¤Î @link CCUnitTestFunc TestFuncs @endlink
-¤ò°ì½ï¤Ë¼Â¹Ô¤¹¤ë
-@link CCUnitTestSuite TestSuite @endlink ¥â¥¸¥å¡¼¥ë¤òÄ󶡤·¤Þ¤¹¡£
-¥Æ¥¹¥È¥¹¡¼¥Ä¤ò¼Â¹Ô¤¹¤ëÊýË¡¤Ï¤¹¤Ç¤ËÁ°¤ÎÊý¤Ç¼¨¤·¤Æ¤¢¤ê¤Þ¤¹¡£
+CCUnit はいくつもの @link CCUnitTestFunc TestFuncs @endlink
+を一緒に実行する
+@link CCUnitTestSuite TestSuite @endlink モジュールを提供します。
+テストスーツを実行する方法はすでに前の方で示してあります。
@endif
@english
To create a suite of two or more tests, you do the following:
@japanese
-Æó¤Ä°Ê¾å¤Î¥Æ¥¹¥È¤ò´Þ¤à°ì¤Ä¤Î¥¹¡¼¥Ä¤òºî¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+二つ以上のテストを含む一つのスーツを作るには、次のようにします。
@endif
@dontinclude complex/runTestSuite.c
@english
Create two test cases, and register test functions to each cases.
@japanese
-¥Æ¥¹¥È¥±¡¼¥¹¤òÆó¤ÄÀ¸À®¤·¡¢¤½¤ì¤¾¤ì¤Ë¥Æ¥¹¥È´Ø¿ô¤òÅÐÏ¿¤·¤Þ¤¹¡£
+テストケースを二つ生成し、それぞれにテスト関数を登録します。
@endif
@skip main
Create a test suite,
then register that two test cases to it.
@japanese
-¥Æ¥¹¥È¥¹¡¼¥Ä¤òÀ¸À®¤·¡¢
-¥Æ¥¹¥È¥±¡¼¥¹¤òÅÐÏ¿¤·¤Þ¤¹¡£
+テストスーツを生成し、
+テストケースを登録します。
@endif
@until testArith);
@english
Create test runner and run the tests.
@japanese
-¥Æ¥¹¥È¥é¥ó¥Ê¡¼¤òÀ¸À®¤·¥Æ¥¹¥È¤ò¼Â¹Ô¤·¤Þ¤¹¡£
+テストランナーを生成しテストを実行します。
@endif
@until }
To compile and run, do the following:
@japanese
-¤³¤³¤Þ¤Ç¤Î¥µ¥ó¥×¥ë¥³¡¼¥É¤Ï¡¢<code>examples/complex</code> ¥Ç¥£¥ì¥¯¥È¥ê¤Î
+ここまでのサンプルコードは、<code>examples/complex</code> ディレクトリの
<code>runTestSuite.c, testComplexSetup.c, testComplexArith.c</code>
-¤Ë¤¢¤ê¤Þ¤¹¡£
+にあります。
-¥³¥ó¥Ñ¥¤¥ë¤ª¤è¤Ó¼Â¹Ô¤¹¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+コンパイルおよび実行するには、次のようにします。
@endif
@code
creating a @link CCUnitTestSuite TestSuite @endlink that
contains both:
@japanese
-@link CCUnitTestSuite TestSuites @endlink ¤Ï
+@link CCUnitTestSuite TestSuites @endlink は
@link CCUnitTestCase TestCases @endlink
-¤ò´Þ¤à¤À¤±¤Ç¤Ï¤¢¤ê¤Þ¤»¤ó¡£
-@link CCUnitTestSuite TestSuites @endlink ¼«¿È¤ò´Þ¤à¤³¤È¤â¤Ç¤¤Þ¤¹¡£
-Î㤨¤Ð¡¢¤¢¤Ê¤¿¤Ï¤¢¤Ê¤¿¤Î¥³¡¼¥É¤Ë @link CCUnitTestSuite TestSuite @endlink
-¤òºî¤ë¤³¤È¤¬¤Ç¤¡¢
-¤½¤·¤Æ»ä¤Ï»ä¤Î¥¹¡¼¥Ä
-¤òºî¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡¢
-¤½¤·¤Æ»äã¤ÏξÊý¤È¤â¤ò´Þ¤ó¤Ç¤¤¤ë @link CCUnitTestSuite TestSuite @endlink
-¤òºî¤Ã¤Æ¡¢
-°ì½ï¤Ë¤½¤ì¤¾¤ì¤Î¥¹¡¼¥Ä¤ò¼Â¹Ô¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¤Î¤Ç¤¹¡£
+を含むだけではありません。
+@link CCUnitTestSuite TestSuites @endlink 自身を含むこともできます。
+例えば、あなたはあなたのコードに @link CCUnitTestSuite TestSuite @endlink
+を作ることができ、
+そして私は私のスーツ
+を作ることができます、
+そして私達は両方ともを含んでいる @link CCUnitTestSuite TestSuite @endlink
+を作って、
+一緒にそれぞれのスーツを実行することができるのです。
@endif
@code
@english
@section helper_tool Helper Tool
@japanese
-@section helper_tool ¥Ø¥ë¥Ñ¡¼¥Ä¡¼¥ë
+@section helper_tool ヘルパーツール
@endif
@english
command have been created to automatically implements the
creating suite function.
@japanese
-¤ªµ¤¤Å¤¤Î¤è¤¦¤Ë¡¢
-¥Æ¥¹¥È¥±¡¼¥¹¤Ë¥Æ¥¹¥È´Ø¿ô¤òÅÐÏ¿¤·¤¿¤ê¡¢
-¥Æ¥¹¥È¥¹¡¼¥Ä¤Ë¥Æ¥¹¥È¥±¡¼¥¹¤òÅÐÏ¿¤·¤¿¤ê¤¹¤ëºî¶È¤Ï¡¢
-È¿ÉüŪ¤Ç´Ö°ã¤¤¤ä¤¹¤¤¤â¤Î¤Ç¤¹¡£
+お気づきのように、
+テストケースにテスト関数を登録したり、
+テストスーツにテストケースを登録したりする作業は、
+反復的で間違いやすいものです。
-Î㤨¤Ð @c testComplexSetup.c ¤Ë¤Ï
-@c test_complex_to_string() ¤È¤¤¤¦¥Æ¥¹¥È´Ø¿ô¤¬ÄêµÁ¤µ¤ì¤Æ¤¤¤Þ¤¹¤¬¡¢
-º£¤Þ¤Ç¤ÎÀâÌÀ¤Ç¤Ï̵»ë¤µ¤ì¤Æ¤¤¤Æ¥Æ¥¹¥È¥±¡¼¥¹¤Ë¤ÏÅÐÏ¿¤µ¤ì¤Þ¤»¤ó¤Ç¤·¤¿¡£
+例えば @c testComplexSetup.c には
+@c test_complex_to_string() というテスト関数が定義されていますが、
+今までの説明では無視されていてテストケースには登録されませんでした。
-¤³¤Î¤è¤¦¤ÊÅÐϿϳ¤ì¤ò¤Ê¤¯¤¹¤¿¤á¤Ë
-@ref CreatingTestSuite ¤Î´Ø¿ô¤È¥³¥Þ¥ó¥É¤Ï¡¢
-¥Æ¥¹¥È¥±¡¼¥¹¤ä¥Æ¥¹¥È¥¹¡¼¥Ä¤òÅÐÏ¿¤¹¤ë´Ø¿ô¤Î¼ÂÁõ¤ò¡¢
-¼«Æ°Åª¤ËºîÀ®¤¹¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
+このような登録漏れをなくすために
+@ref CreatingTestSuite の関数とコマンドは、
+テストケースやテストスーツを登録する関数の実装を、
+自動的に作成することができます。
@endif
@english
As for the comment of the javaDoc style,
the starts of the comment block of the C style are two asterisks "<tt>**</tt>".
@japanese
-¤½¤Î¤¿¤á¤Ë¤Ï¡¢¥Æ¥¹¥È¥±¡¼¥¹¤ò½ñ¤¯¥Õ¥¡¥¤¥ë¤ò¼¡¤Î¤è¤¦¤Ëºî¤ê¤Þ¤¹¡£
+そのためには、テストケースを書くファイルを次のように作ります。
-ºÇ½é¤Ë¡¢¥Æ¥¹¥È¥¹¡¼¥Ä¤òÀë¸À¤·¤Þ¤¹¡£
-¤³¤ì¤Ï javaDoc ¥¹¥¿¥¤¥ë¤Î¥³¥á¥ó¥ÈÆâ¤Ë¥Æ¥¹¥È¥¹¡¼¥Ä¤Î̾Á°¤òµ½Ò¤·¤Þ¤¹¡£
-javaDoc¥¹¥¿¥¤¥ë¤Î¥³¥á¥ó¥È¤È¤Ï C ¥¹¥¿¥¤¥ë¤Î¥³¥á¥ó¥È¥Ö¥í¥Ã¥¯¤Î³«»Ï¤¬
-Æó¤Ä¤Î¥¢¥¹¥¿¥ê¥¹¥¯ <tt>**</tt> ¤Ë¤Ê¤Ã¤Æ¤¤¤ë¤â¤Î¤Ç¤¹¡£
+最初に、テストスーツを宣言します。
+これは javaDoc スタイルのコメント内にテストスーツの名前を記述します。
+javaDocスタイルのコメントとは C スタイルのコメントブロックの開始が
+二つのアスタリスク <tt>**</tt> になっているものです。
@endif
@code
One file can define the multiple test case.
@japanese
-¼¡¤Ë¡¢
-¥Æ¥¹¥È¥±¡¼¥¹¤òÄêµÁ¤·¤Þ¤¹¡£
-¥Æ¥¹¥È¥±¡¼¥¹¤Ï javaDoc ¥¹¥¿¥¤¥ë¤Î¥³¥á¥ó¥È¤Ë½ñ¤«¤ì¤¿¥Æ¥¹¥È¥±¡¼¥¹¤Î̾Á°¤ÎÀë¸À¤È¡¢
-¥Æ¥¹¥È¥±¡¼¥¹¤Î½ªÎ»¤ÎÀë¸À¤Ç°Ï¤Þ¤ì¤¿¥°¥í¡¼¥Ð¥ëÊÑ¿ô¤È´Ø¿ô¤Î½¸¤Þ¤ê¤Ç¤¹¡£
-¤Ò¤È¤Ä¤Î¥Õ¥¡¥¤¥ë¤ËÊ£¿ô¤Î¥Æ¥¹¥È¥±¡¼¥¹¤òÄêµÁ¤Ç¤¤Þ¤¹¡£
+次に、
+テストケースを定義します。
+テストケースは、 javaDoc スタイルのコメントに書かれたテストケースの名前の宣言と
+テストケースの終了の宣言で囲まれた、グローバル変数と関数の集まりです。
+ひとつのファイルに複数のテストケースを定義できます。
@endif
@code
I explained before so that you may know it from that name.
Define as the function to begin respectively with such a name.
@japanese
-¥Æ¥¹¥È´Ø¿ô¤Ï̾Á°¤¬ @c test ¤Ç»Ï¤Þ¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤ê¤Þ¤»¤ó¡£
-¤Þ¤¿³Æ¥Æ¥¹¥È´Ø¿ô¤ÎÁ°¤Ë¤Ï
-javaDoc ¥¹¥¿¥¤¥ë¤Î¥³¥á¥ó¥È¤ÎÃæ¤Ë¥Æ¥¹¥È´Ø¿ô¤ÎÀâÌÀ¤ò½ñ¤¯¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
-¥³¥á¥ó¥È¤¬½ñ¤«¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¡¢
-¥Æ¥¹¥È´Ø¿ô¤Î̾Á°¤¬´Ø¿ô¤ÎÀâÌÀ¤È¤·¤ÆÅÐÏ¿¤µ¤ì¤Þ¤¹¡£
+テスト関数は名前が @c test で始まっていなければなりません。
+また各テスト関数の前には
+javaDoc スタイルのコメントの中にテスト関数の説明を書くことができます。
+コメントが書かれていなければ、
+テスト関数の名前が関数の説明として登録されます。
-ÆÃÊ̤ʥƥ¹¥È´Ø¿ô¤È¤·¤Æ @c setUp, @c tearDown, @c setUpBeforeClass,
-@c tearDownAfterClass ¤¬¤¢¤ê¤Þ¤¹¡£
-¤½¤Î̾Á°¤«¤é¤ï¤«¤ë¤è¤¦¤Ë¡¢
-°ÊÁ°¤ËÀâÌÀ¤·¤¿¥Æ¥¹¥È¥±¡¼¥¹¤Îµ¡Ç½¤Î´Ø¿ô¤È¤·¤ÆƯ¤¤Þ¤¹¡£
-¤½¤ì¤¾¤ì¤½¤Î¤è¤¦¤Ê̾Á°¤ÇÄêµÁ¤·¤Æ¤¯¤À¤µ¤¤¡£
+特別なテスト関数として @c setUp, @c tearDown, @c setUpBeforeClass,
+@c tearDownAfterClass があります。
+その名前からわかるように、
+以前に説明したテストケースの機能の関数として働きます。
+それぞれそのような名前で定義してください。
@endif
@english
To generate creating suite function code, run
<code>ccunit_makeSuite</code> tool.
@japanese
-¥¹¡¼¥ÄºîÀ®´Ø¿ô¤Î¥³¡¼¥É¤òÀ¸À®¤¹¤ë¤Ë¤Ï¡¢
-<code>ccunit_makeSuite</code>¥Ä¡¼¥ë¤ò¼Â¹Ô¤·¤Þ¤¹¡£
+スーツ作成関数のコードを生成するには、
+<code>ccunit_makeSuite</code>ツールを実行します。
@endif
@english
name by the <code>-f</code> option of the
<code>ccunit_makeSuite</code> command, too.
@japanese
-¼«Æ°Åª¤ËºîÀ®¤µ¤ì¤ë
+自動的に作成される
@link CCUnitTestSuite TestSuite @endlink
-¤òºîÀ®¤¹¤ë´Ø¿ô¤Ï¡¢
-¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï <code>ccunit_suite</code> ¤Ç¤¹¡¢
-¤·¤«¤· <code>ccunit_makeSuite</code> ¥³¥Þ¥ó¥É¤Î
-<code>-f</code> ¥ª¥×¥·¥ç¥ó¤ÇÊ̤Î̾Á°¤ËÊѤ¨¤ë¤³¤È¤â¤Ç¤¤Þ¤¹¡£
+を作成する関数は、
+デフォルトでは <code>ccunit_suite</code> です、
+しかし <code>ccunit_makeSuite</code> コマンドの
+<code>-f</code> オプションで別の名前に変えることもできます。
@endif
@code
@english
The next is taken to use the code which you generated automatically.
@japanese
-¼«Æ°À¸À®¤·¤¿¥³¡¼¥É¤òÍøÍѤ¹¤ë¤Ë¤Ï¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+自動生成したコードを利用するには次のようにします。
@endif
@dontinclude complex/runTestSuiteAuto.c
Declare the prototype of the function which you generated.
Try not to forget <code>char* name</code> of the argument.
@japanese
-À¸À®¤·¤¿´Ø¿ô¤Î¥×¥í¥È¥¿¥¤¥×¤òÀë¸À¤·¤Þ¤¹¡£
-°ú¿ô¤Î <code>char* name</code> ¤ò˺¤ì¤Ê¤¤¤è¤¦¤Ë¤·¤Æ¤¯¤À¤µ¤¤¡£
+生成した関数のプロトタイプを宣言します。
+引数の <code>char* name</code> を忘れないようにしてください。
@endif
@skip include
@english
Call the function which you generated, and take out the test suite.
@japanese
-À¸À®¤·¤¿´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤Æ¥Æ¥¹¥È¥¹¡¼¥Ä¤ò¼è¤ê½Ð¤·¤Þ¤¹¡£
+生成した関数を呼び出してテストスーツを取り出します。
@endif
@skip main
@english
Run it by the test runner.
@japanese
-¥Æ¥¹¥È¥é¥ó¥Ê¡¼¤Ç¼Â¹Ô¤·¤Þ¤¹¡£
+テストランナーで実行します。
@endif
@until }
To compile and run, do the following:
@japanese
-¤³¤³¤Þ¤Ç¤Î¥µ¥ó¥×¥ë¥³¡¼¥É¤Ï¡¢<code>examples/complex</code> ¥Ç¥£¥ì¥¯¥È¥ê¤Î
+ここまでのサンプルコードは、<code>examples/complex</code> ディレクトリの
<code>runTestSuiteAuto.c</code>, <code>testComplexSetup.c</code>
-¤Ë¤¢¤ê¤Þ¤¹¡£
+にあります。
-¥³¥ó¥Ñ¥¤¥ë¤ª¤è¤Ó¼Â¹Ô¤¹¤ë¤Ë¤Ï¡¢¼¡¤Î¤è¤¦¤Ë¤·¤Þ¤¹¡£
+コンパイルおよび実行するには、次のようにします。
@endif
@code
@english
@section sample_programs Sample Programs
@japanese
-@section sample_programs ¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à
+@section sample_programs サンプルプログラム
@endif
@english
The sample program made in the above is in the @c examples/complex directory.
@japanese
-°Ê¾å¤ÇºîÀ®¤·¤¿¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ï @c examples/complex ¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤¢¤ê¤Þ¤¹¡£
+以上で作成したサンプルプログラムは @c examples/complex ディレクトリにあります。
@endif
@copydetails examples
[see also <a href="../ja/index.html">Japanese</a> documents]
</p>
@~japanese
-CCUnit ¤Ï C ¸À¸ì¤Ç·«¤êÊÖ¤·²Äǽ¤Ê¥Æ¥¹¥È¤ò½ñ¤¯¤¿¤á¤Î´Êñ¤Ê¥Õ¥ì¡¼¥à¥ï¡¼¥¯¤Ç¤¹¡£
+CCUnit は C 言語で繰り返し可能なテストを書くための簡単なフレームワークです。
</p>
<p>
[see also <a href="../../index.html">English</a> documents]
@english
@section _installation Installation
@japanese
-@section _installation ¥¤¥ó¥¹¥È¡¼¥ë
+@section _installation インストール
@endif
@~english
Below are the installation steps for installing CCUnit:
@~japanese
-°Ê²¼¤Ë CCUnit¤ò¥¤¥ó¥¹¥È¡¼¥ë¤¹¤ë¼ê½ç¤ò¼¨¤·¤Þ¤¹¡£
+以下に CCUnitをインストールする手順を示します。
@~
@english
</ol>
@japanese
<ol>
-<li>¥¢¡¼¥«¥¤¥Ö¥Õ¥¡¥¤¥ë¤òŸ³«¤·¤Þ¤¹¡£</li>
-<li>Ÿ³«¤·¤¿¥Ç¥£¥ì¥¯¥È¥ê¤Ëcd¤·¤Þ¤¹¡£</li>
-<li>`<code>./configure</code>' ¥Õ¥¡¥¤¥ë¤ò¼Â¹Ô¤·¤Þ¤¹¡£</li>
-<li><code>make</code> ¤È¥¿¥¤¥×¤·¤Æ ccunit ¥é¥¤¥Ö¥é¥ê¤òºîÀ®¤·¤Þ¤¹¡£</li>
-<li><code>make install</code> ¤È¤·¤Æ¥¤¥ó¥¹¥È¡¼¥ë¤·¤Þ¤¹¡£</li>
+<li>アーカイブファイルを展開します。</li>
+<li>展開したディレクトリにcdします。</li>
+<li>`<code>./configure</code>' ファイルを実行します。</li>
+<li><code>make</code> とタイプして ccunit ライブラリを作成します。</li>
+<li><code>make install</code> としてインストールします。</li>
</ol>
@endif
@english
@section _usage Getting Started
@japanese
-@section _usage ¤µ¤¢»Ï¤á¤Þ¤·¤ç¤¦
+@section _usage さあ始めましょう
@endif
@~english
<a href="modules.html">Modules</a> give
you a organized view of %CCUnit modules.
@~japanese
-<a href="modules.html">¥â¥¸¥å¡¼¥ë</a>
-¥»¥¯¥·¥ç¥ó¤Ï CCUnit ¤Î¥â¥¸¥å¡¼¥ë¤òÀ°Íý¤·¤Æɽ¼¨¤·¤Æ¤¤¤Þ¤¹¡£
+<a href="modules.html">モジュール</a>
+セクションは CCUnit のモジュールを整理して表示しています。
@~
@english
@section _sample_codes Sample Codes
@japanese
-@section _sample_codes ¥µ¥ó¥×¥ë¥³¡¼¥É
+@section _sample_codes サンプルコード
@endif
@copydoc examples
@english
@section _documentation Documentation
@japanese
-@section _documentation ¥É¥¥å¥á¥ó¥È
+@section _documentation ドキュメント
@endif
<dl>
href="../ja/cookbook.html">cookbook in
japanese</a>)
@~japanese
- CCUnit¤Ç¥Æ¥¹¥È¤ò¼ÂÁõ¤¹¤ë¤¿¤á¤Î<a href="cookbook.html">¥¯¥Ã¥¯¥Ö¥Ã¥¯</a>
+ CCUnitã\81§ã\83\86ã\82¹ã\83\88ã\82\92å®\9fè£\85ã\81\99ã\82\8bã\81\9fã\82\81ã\81®<a href="cookbook.html">ã\82¯ã\83\83ã\82¯ã\83\96ã\83\83ã\82¯</a>
(see also <a
href="../../cookbook.html">Cookbook in
English</a> Edition)
@english
@section _license Lincense
@japanese
-@section _license ¥é¥¤¥»¥ó¥¹
+@section _license ã\83©ã\82¤ã\82»ã\83³ã\82¹
@endif
@~english
<a href="http://www.gnu.org/copyleft/lesser.html"
>Lesser General Public License</a> version 2.
@~japanese
-¤³¤Î¥é¥¤¥Ö¥é¥ê¤Ï¡¢GNU <a href="http://www.gnu.org/copyleft/lesser.html"
->Lesser General Public License</a> ¥Ð¡¼¥¸¥ç¥ó 2 ¤Î¸µ¤ÇÇÛÉÛ¤·¤Æ¤¤¤Þ¤¹¡£
+このライブラリは、GNU <a href="http://www.gnu.org/copyleft/lesser.html"
+>Lesser General Public License</a> バージョン 2 の元で配布しています。
@~
@english
@section _links Related Links
@japanese
-@section _links ´ØÏ¢¥ê¥ó¥¯
+@section _links é\96¢é\80£ã\83ªã\83³ã\82¯
@endif
- C Test Units
- <a href="http://cunit.sourceforge.net/">CUnit</a>:
@~english CUnit is Unit Testing Framework for 'C' language.
- @~japanese CUnit ¤Ï 'C' ¸À¸ì¤Î¥æ¥Ë¥Ã¥È¥Æ¥¹¥È¥Õ¥ì¡¼¥à¥ï¡¼¥¯¤Ç¤¹¡£@~
+ @~japanese CUnit は 'C' 言語のユニットテストフレームワークです。@~
- <a href="http://sourceforge.net/projects/embunit/">EmbUnit</a>,
<a href="http://sourceforge.jp/projects/embunit/">EmbUnit</a>:
@~english
more, and then adapted somewhat for Embedded C
System. Embedded Unit does not require std C libs. All
objects are allocated to const area.
- @~japanese EmbeddedUnit ¤Ï
- C ¸À¸ì¤ò»È¤Ã¤¿ÁȤ߹þ¤ß·Ï³«È¯¸þ¤±¤Î¥Æ¥¹¥È¥æ¥Ë¥Ã¥È¥Õ¥ì¡¼¥à¥ï¡¼¥¯¤Ç¤¹¡£
- C ɸ½à¥é¥¤¥Ö¥é¥ê¤ò»È¤ï¤Ê¤¤¤Î¤Ç¼Â¹Ô»ñ¸»¤Î¾¯¤Ê¤¤¥¿¡¼¥²¥Ã¥È´Ä¶¤Ç¤âÆ°ºî²Äǽ¤Ç¤¹¡£@~
+ @~japanese EmbeddedUnit は
+ C 言語を使った組み込み系開発向けのテストユニットフレームワークです。
+ C 標準ライブラリを使わないので実行資源の少ないターゲット環境でも動作可能です。@~
- <a href="http://junit.org/index.htm">JUnit</a>:
@~english JUnit is a regression testing framework written
by Erich Gamma and Kent Beck. It is used by the
developer who implements unit tests in Java.
- @~japanese JUnit¤Ï¥ê¥°¥ì¥Ã¥·¥ç¥ó¥Æ¥¹¥È¥Õ¥ì¡¼¥à¥ï¡¼¥¯¤Ç¤¢¤ê¡¢
- Erich Gamma ¤È Kent Beck ¤Ë¤è¤Ã¤Æ½ñ¤«¤ì¤Þ¤·¤¿¡£
- ¤³¤ì¤Ï Java ¤Ç¥Æ¥¹¥È¥æ¥Ë¥Ã¥È¤ò¼ÂÁõ¤¹¤ë³«È¯¼Ô¤¬»ÈÍѤ·¤Þ¤¹¡£@~
+ @~japanese JUnitはリグレッションテストフレームワークであり、
+ Erich Gamma と Kent Beck によって書かれました。
+ これは Java でテストユニットを実装する開発者が使用します。@~
- C++ Test Units
- <a href="http://cppunit.sourceforge.net/cgi-bin/moin.cgi">CppUnit</a>:
@~english CppUnit is a C++ unit testing framework.
- @~japanese CppUnit ¤Ï C++ ¥æ¥Ë¥Ã¥È¥Æ¥¹¥È¥Õ¥ì¡¼¥à¥ï¡¼¥¯¤Ç¤¹¡£@~
+ @~japanese CppUnit は C++ ユニットテストフレームワークです。@~
- <a href="http://cxxtest.sourceforge.net/">CxxTest</a>:
@~english CxxTest is a JUnit/CppUnit/xUnit-like framework for C++.
- @~japanese CxxTest ¤Ï JUnit/CppUnit/xUnit ¥é¥¤¥¯¤Î C++Íѥե졼¥à¥ï¡¼¥¯¤Ç¤¹¡£@~
+ @~japanese CxxTest は JUnit/CppUnit/xUnit ライクの C++用フレームワークです。@~
- <a href="http://sourceforge.net/projects/ccunit">ccUnit</a>:
@~english ccUnit is a C++ unit testing framework.
- @~japanese ccUnit ¤Ï C++ ¥æ¥Ë¥Ã¥È¥Æ¥¹¥È¥Õ¥ì¡¼¥à¥ï¡¼¥¯¤Ç¤¹¡£@~
+ @~japanese ccUnit は C++ ユニットテストフレームワークです。@~
- eXtreme Programing
- <a href="http://www.xprogramming.com/index.htm">XProgramming.com</a>:
@~english an Extreme Programming Resources.
- @~japanese ¥¨¥¯¥¹¥È¥ê¡¼¥à¥×¥í¥°¥é¥ß¥ó¥°¤Î¥ê¥½¡¼¥¹½¸¤Ç¤¹¡£@~
+ @~japanese エクストリームプログラミングのリソース集です。@~
*/
* @english
* @defgroup Construction Construction
* @japanese
- * @defgroup Construction ¹½À®
+ * @defgroup Construction 構成
* @endif
*
* @english
* Test case can have @c setUp and @c tearDown functions
* which are called before and after running the test cases.
* @japanese
- * CCUnit ¤Ï¥Æ¥¹¥È¥¹¡¼¥Ä¡¢¥Æ¥¹¥È¥±¡¼¥¹¡¢¥Æ¥¹¥È´Ø¿ô¤«¤é¹½À®¤µ¤ì¤Þ¤¹
+ * CCUnit はテストスーツ、テストケース、テスト関数から構成されます
*
- * Ê£¿ô¤Î¥Æ¥¹¥È´Ø¿ô¤Ï¥Æ¥¹¥È¥±¡¼¥¹¤Ë¤Þ¤È¤á¤é¤ì¡¢
- * ¤¤¤¯¤Ä¤«¤Î¥Æ¥¹¥È¥±¡¼¥¹¤Ï¥Æ¥¹¥È¥¹¡¼¥Ä¤Ë¤Þ¤È¤á¤é¤ì¤Þ¤¹¡£
- * ¤½¤·¤Æ¥Æ¥¹¥È¥¹¡¼¥Ä¤â¤Þ¤¿¥Æ¥¹¥È¥¹¡¼¥Ä¤Ë¤Þ¤È¤á¤ë¤³¤È¤¬¤Ç¤¤Þ¤¹¡£
- * ¥Æ¥¹¥È¥¹¡¼¥Ä¤ò¼Â¹Ô¤¹¤ë¤È¡¢¤½¤ì¤Ë¤Þ¤È¤á¤é¤ì¤Æ¤¤¤ë¥Æ¥¹¥È¥¹¡¼¥Ä¡¢
- * ¥Æ¥¹¥È¥±¡¼¥¹¡¢¥Æ¥¹¥È´Ø¿ô¤¬ÅÐÏ¿¤µ¤ì¤¿½ç¤Ë¼Â¹Ô¤µ¤ì¤Þ¤¹¡£
- * ¥Æ¥¹¥È¥±¡¼¥¹¤Ë¤Ï @c setUp ¤È @c tearDown ´Ø¿ô¤òÅÐÏ¿¤¹¤ë¤³¤È¤¬¤Ç¤¡¢
- * ¤½¤ì¤é¤Ï¥Æ¥¹¥È¥±¡¼¥¹¤Î¥Æ¥¹¥È´Ø¿ô¤¬¼Â¹Ô¤µ¤ì¤ëÁ°¤È¸å¤Ë¼Â¹Ô¤µ¤ì¤Þ¤¹¡£
+ * 複数のテスト関数はテストケースにまとめられ、
+ * いくつかのテストケースはテストスーツにまとめられます。
+ * そしてテストスーツもまたテストスーツにまとめることができます。
+ * テストスーツを実行すると、それにまとめられているテストスーツ、
+ * テストケース、テスト関数が登録された順に実行されます。
+ * テストケースには @c setUp と @c tearDown 関数を登録することができ、
+ * それらはテストケースのテスト関数が実行される前と後に実行されます。
* @endif
*
* @dot
* @defgroup Assertions Assert Macros
* There are the macros for assertions by test functions.
* @japanese
- * @defgroup Assertions ASSERT ¥Þ¥¯¥í
- * ¥Æ¥¹¥È´Ø¿ô¤ÇɽÌÀ (ASSERT) ¤ò¹Ô¤¦¤¿¤á¤Î¥Þ¥¯¥í¤Ç¤¹¡£
+ * @defgroup Assertions ASSERT マクロ
+ * テスト関数で表明 (ASSERT) を行うためのマクロです。
*
- * ¤â¤Ã¤È¤â¥×¥ê¥ß¥Æ¥£¥Ö¤Ê¤Î¤Ï CCUNIT_ASSERT() ¤Ë¤Ê¤ê¤Þ¤¹¤¬¡¢
- * Ä̾ï CCUNIT_ASSERT_ASSERT_EQ_INT() ¤Ê¤É¤Î
- * ¥³¥ó¥Ó¥Ë¥¨¥ó¥¹¤Ê¥Þ¥¯¥í¤ò»È¤¦¤³¤È¤Ë¤Ê¤ë¤Ç¤·¤ç¤¦¡£
+ * もっともプリミティブなのは CCUNIT_ASSERT() になりますが、
+ * 通常 CCUNIT_ASSERT_ASSERT_EQ_INT() などの
+ * コンビニエンスなマクロを使うことになるでしょう。
* @endif
*/
* @english
* @defgroup WritingTestCase Writing Test Case
* @japanese
- * @defgroup WritingTestCase ¥Æ¥¹¥È¥±¡¼¥¹¤ò½ñ¤¯
- * ¥Æ¥¹¥È´Ø¿ô¤Î½¸¤Þ¤ê¤Î¥Æ¥¹¥È¥±¡¼¥¹¤ò½ñ¤¤Þ¤¹¡£
+ * @defgroup WritingTestCase テストケースを書く
+ * テスト関数の集まりのテストケースを書きます。
* @endif
*/
* @english
* @defgroup CreatingTestSuite Creating TestSuite
* @japanese
- * @defgroup CreatingTestSuite ¥Æ¥¹¥È¥¹¡¼¥Ä¤ÎÀ¸À®
- * ¤¤¤¯¤Ä¤«¤Î¥Æ¥¹¥È¥±¡¼¥¹¤ä¥Æ¥¹¥È¥¹¡¼¥Ä¤ò¤Þ¤È¤á¤Æ¡¢
- * ¤Ò¤È¤Ä¤Î¥Æ¥¹¥È¥¹¡¼¥Ä¤Ë¤·¤Þ¤¹¡£
+ * @defgroup CreatingTestSuite テストスーツの生成
+ * いくつかのテストケースやテストスーツをまとめて、
+ * ひとつのテストスーツにします。
* @endif
* @sa CCUnitMakeSuite
*/
* @english
* @defgroup ExecutingTest Executing Test
* @japanese
- * @defgroup ExecutingTest ¥Æ¥¹¥È¤Î¼Â¹Ô
- * ¥Æ¥¹¥È¥¹¡¼¥Ä¤ò¼Â¹Ô¤·¤Þ¤¹¡£
+ * @defgroup ExecutingTest テストの実行
+ * テストスーツを実行します。
* @endif
*/
* @english
* @defgroup TrackingTestExecution Tracking Test Execution
* @japanese
- * @defgroup TrackingTestExecution ¥Æ¥¹¥È¤Î¼Â¹Ô¤ÎÄÉÀ×
- * ¥Æ¥¹¥È¤Î¼Â¹Ô¤òÄÉÀפ·¤Þ¤¹¡£
+ * @defgroup TrackingTestExecution テストの実行の追跡
+ * テストの実行を追跡します。
* @endif
*/
* @english
* @defgroup BrowsingCollectedTestResult Browsing Collected Test Result
* @japanese
- * @defgroup BrowsingCollectedTestResult ¥Æ¥¹¥È·ë²Ì¤Î»²¾È
- * ¥Æ¥¹¥È·ë²Ì¤ò»²¾È¤·¤Þ¤¹¡£
+ * @defgroup BrowsingCollectedTestResult テスト結果の参照
+ * テスト結果を参照します。
* @endif
*/
* @english
* @defgroup ModuleHierarchy Module Hierarchy
* @japanese
- * @defgroup ModuleHierarchy ¥â¥¸¥å¡¼¥ë³¬ÁØ
+ * @defgroup ModuleHierarchy モジュール階層
* @endif
*/
* @english
* @defgroup examples Sample Programs
* @japanese
- * @defgroup examples ¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à
+ * @defgroup examples サンプルプログラム
* @endif
*
* @~english You find additional samples in the examples directory.
- * @~japanese examples ¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤Ï¥µ¥ó¥×¥ë¥Õ¥¡¥¤¥ë¤¬¤¢¤ê¤Þ¤¹¡£@~
+ * @~japanese examples ディレクトリにはサンプルファイルがあります。@~
*
* - complex - @~english some complex number library test cases
- * @~japanese Ê£ÁÇ¿ô¤ò·×»»¤¹¤ë¥é¥¤¥Ö¥é¥ê¤È¤½¤Î¥Æ¥¹¥È¥±¡¼¥¹¤Î¥µ¥ó¥×¥ë¤Ç¤¹¡£@~
+ * @~japanese 複素数を計算するライブラリとそのテストケースのサンプルです。@~
* - libcomplex.a - complex number library
* - complex.c
* - complex.h
- * - runTestCase @~japanese - ¤â¤Ã¤È¤âñ½ã¤Ê¥Æ¥¹¥È¥±¡¼¥¹¤ò¼Â¹Ô¤¹¤ë¥µ¥ó¥×¥ë¤Ç¤¹¡£@~
+ * - runTestCase @~japanese - もっとも単純なテストケースを実行するサンプルです。@~
* - runTestCase.c - main program
* - testComplex.c - test cases
- * - runTestCaseRunner @~japanese - ¥Æ¥¹¥È¥±¡¼¥¹¤ò¥Æ¥¹¥È¥é¥ó¥Ê¡¼¤Ç¼Â¹Ô¤¹¤ë¥µ¥ó¥×¥ë¤Ç¤¹¡£@~
+ * - runTestCaseRunner @~japanese - テストケースをテストランナーで実行するサンプルです。@~
* - runTestCaseRunner.c - main program
* - testComplex.c - test cases
- * - runTestCaseSetup @~japanese - ¥»¥Ã¥È¥¢¥Ã¥×´Ø¿ô¤ò¼Â¹Ô¤¹¤ë¥µ¥ó¥×¥ë¤Ç¤¹¡£@~
+ * - runTestCaseSetup @~japanese - セットアップ関数を実行するサンプルです。@~
* - runTestCaseSetup.c - main program
* - testComplexSetup.c - test cases
- * - runTestSuite @~japanese - ¥Æ¥¹¥È¥¹¡¼¥Ä¤Î¥µ¥ó¥×¥ë¤Ç¤¹¡£@~
+ * - runTestSuite @~japanese - テストスーツのサンプルです。@~
* - runTestSuite.c - main program
* - testComplexSetup.c - test cases
* - testComplexArith.c - test cases
- * - runTestSuiteAuto @~japanese - ¥Æ¥¹¥È¥¹¡¼¥Ä¤ò¼«Æ°À¸À®¤¹¤ë¥µ¥ó¥×¥ë¤Ç¤¹¡£@~
+ * - runTestSuiteAuto @~japanese - テストスーツを自動生成するサンプルです。@~
* - runTest.c - main program
* - testComplexSetup.c - test cases
* - testComplexArith.c - test cases