sdk/lib/3rdparty/stlport/build/test/unit/README

   1 $Id$
   2
   3 ===========================
   4 STLport testing unit README
   5 ===========================
   6
   7 =======
   8 Purpose
   9 =======
  10 Provide independent STLport unit tests, with clearly defined pass/failed
  11 result for every single test without any user action (i.e. diff)
  12 and without any input request (i.e. files, cin input ...).
  13
  14 =====
  15 Build
  16 =====
  17 Use makefile(s):
  18
  19 make -f gcc.mak
  20
  21 ======================
  22 Running the test suite
  23 ======================
  24 commad-line syntax as follows:
  25   stl_unit_test [OPTIONS]
  26   where OPTIONS are
  27    -t=CLASS[::TEST]    run the test class CLASS or member test CLASS::TEST
  28    -f=FILE             save output in file FILE instead of stdout
  29
  30 examples:
  31 ./stl_unit_test
  32  - runs all tests registered with this unit
  33
  34 ./stl_unit_test -f=out.txt
  35  - runs all tests registered with this unit but print results into out.txt instead of stdout
  36
  37 ./stl_unit_test -t=VectorTest
  38  - runs all tests registered in VectorTest class
  39
  40 ./stl_unit_test -t=VectorTest::vec_test_1  -f=out.txt
  41  - runs only VectorTest::vec_test_1() test, print result into out.txt instead of stdout
  42
  43 ==================
  44 CU mini background
  45 ==================
  46 see:
  47 http://www.stlport.com/dcforum/DCForumID5/764.html
  48
  49 Note: cppunit mini sources are modified from original!
  50
  51 ===============
  52 Adding new test
  53 ===============
  54 You can add/create new tests easily just use _template.cpp as your new
  55 test class and do not forget to edit Makefile.inc
  56
  57 For guide to CppUnit like tests see http://cppunit.sourceforge.net/
  58
  59 ==============================================
  60 Replacement of regression by unit tests:
  61 ==============================================
  62
  63 regression                  unit
  64 -----------------------------------------
  65 accum1.cpp              accum_test.cpp
  66 accum2.cpp
  67
  68 adjdiff0.cpp            adj_test.cpp
  69 adjdiff1.cpp
  70 adjdiff2.cpp
  71 adjfind0.cpp
  72 adjfind1.cpp
  73 adjfind2.cpp
  74
  75 advance.cpp             advance_test.cpp
  76
  77 alg1.cpp                alg_test.cpp
  78 alg2.cpp
  79 alg3.cpp
  80 alg4.cpp
  81 alg5.cpp
  82
  83 bcompos1.cpp            bcompos_test.cpp
  84 bcompos2.cpp
  85
  86 bind1st1.cpp            bind_test.cpp
  87 bind1st2.cpp
  88 bind2nd1.cpp
  89 bind2nd2.cpp
  90
  91 binsert1.cpp            binsert_test.cpp
  92 binsert2.cpp
  93
  94 binsrch1.cpp            bsearch_test.cpp
  95 binsrch2.cpp
  96
  97 bnegate1.cpp            bnegate_test.cpp
  98 bnegate2.cpp
  99
 100 bvec1.cpp               bvector_test.cpp
 101
 102 bug.cpp                 -
 103
 104 copy1.cpp               copy_test.cpp
 105 copy2.cpp
 106 copy3.cpp
 107 copy4.cpp
 108 copyb0.cpp
 109 copyb.cpp
 110
 111 count0.cpp              count_test.cpp
 112 count1.cpp
 113 countif1.cpp
 114
 115 deque1.cpp              deque_test.cpp
 116
 117 divides.cpp             divides_test.cpp
 118
 119 eqlrnge0.cpp            equal_test.cpp
 120 eqlrnge1.cpp
 121 eqlrnge2.cpp
 122 equal0.cpp
 123 equal1.cpp
 124 equal2.cpp
 125 equalto.cpp
 126
 127 fill1.cpp               fill_test.cpp
 128 filln1.cpp
 129
 130 find0.cpp               find_test.cpp
 131 find1.cpp
 132 findif0.cpp
 133 findif1.cpp
 134
 135 finsert1.cpp            finsert_test.cpp
 136 finsert2.cpp
 137
 138 float_input.cpp         floatio_test.cpp
 139 float_output.cpp
 140
 141 foreach0.cpp            foreach_test.cpp
 142 foreach1.cpp
 143
 144 fstream1.cpp            -
 145
 146 func1.cpp               func_test.cpp
 147 func2.cpp
 148 func3.cpp
 149
 150 gener1.cpp              generator_test.cpp
 151 gener2.cpp
 152 genern1.cpp
 153 genern2.cpp
 154
 155 greateq.cpp             greater_test.cpp
 156 greater.cpp
 157
 158 hmap1.cpp               hash_test.cpp
 159 hmmap1.cpp
 160 hmset1.cpp
 161 hset2.cpp
 162
 163 incl0.cpp               includes_test.cpp
 164 incl1.cpp
 165 incl2.cpp
 166
 167 inplmrg1.cpp            inplace_test.cpp
 168 inplmrg2.cpp
 169
 170 inrprod0.cpp            innerprod_test.cpp
 171 inrprod1.cpp
 172 inrprod2.cpp
 173
 174 insert1.cpp             insert_test.cpp
 175 insert2.cpp
 176
 177 ioiter.cpp              ioiter_test.cpp
 178
 179 iota1.cpp               iota_test.cpp
 180
 181 istmit1.cpp             istmit_test.cpp
 182
 183 iter1.cpp               iter_test.cpp
 184 iter2.cpp
 185 iter3.cpp
 186 iter4.cpp
 187 iterswp.cpp
 188
 189 less.cpp                less_test.cpp
 190 lesseq.cpp
 191
 192 lexcmp1.cpp             lexcmp_test.cpp
 193 lexcmp2.cpp
 194
 195 list1.cpp               list_test.cpp
 196 list2.cpp
 197 list3.cpp
 198 list4.cpp
 199
 200 logicand.cpp            logic_test.cpp
 201 logicnot.cpp
 202 logicor.cpp
 203
 204 lwrbnd1.cpp             bound_test.cpp
 205 lwrbnd2.cpp
 206 uprbnd1.cpp
 207 uprbnd2.cpp
 208
 209 map1.cpp                map_test.cpp
 210 mmap1.cpp
 211 mmap2.cpp
 212
 213 max1.cpp                max_test.cpp
 214 max2.cpp
 215 maxelem1.cpp
 216 maxelem2.cpp
 217
 218 memfunptr.cpp           mfunptr_test.cpp
 219
 220 merge0.cpp              merge_test.cpp
 221 merge1.cpp
 222 merge2.cpp
 223
 224 min1.cpp                min_test.cpp
 225 min2.cpp
 226 minelem1.cpp
 227 minelem2.cpp
 228
 229 minus.cpp               plusminus.cpp
 230
 231 mismtch0.cpp            mismatch_test.cpp
 232 mismtch1.cpp
 233 mismtch2.cpp
 234
 235 mkheap0.cpp             heap_test.cpp
 236 mkheap1.cpp
 237 pheap0.cpp
 238 pheap1.cpp
 239
 240 modulus.cpp             modulus_test.cpp
 241
 242 move_constructor.cpp    mvctor_test.cpp
 243
 244 multiset.cpp            multiset_test.cpp
 245
 246 negate.cpp              neq_test.cpp
 247 nequal.cpp
 248
 249 nextprm0.cpp            perm_test.cpp
 250 nextprm1.cpp
 251 nextprm2.cpp
 252 prevprm0.cpp
 253 prevprm1.cpp
 254 prevprm2.cpp
 255
 256 nthelem0.cpp            nthelm_test.cpp
 257 nthelem1.cpp
 258 nthelem2.cpp
 259
 260 ostmit.cpp              ostmit_test.cpp
 261
 262 pair0.cpp               pair_test.cpp
 263 pair1.cpp
 264 pair2.cpp
 265
 266 parsrt0.cpp             partial_test.cpp
 267 parsrt1.cpp
 268 parsrt2.cpp
 269 parsrtc0.cpp
 270 parsrtc1.cpp
 271 parsrtc2.cpp
 272 partsum0.cpp
 273 partsum1.cpp
 274 partsum2.cpp
 275
 276 pqueue1.cpp             queue_test.cpp
 277 queue1.cpp
 278
 279 ptition0.cpp            partition_test.cpp
 280 ptition1.cpp
 281 stblptn0.cpp
 282 stblptn1.cpp
 283
 284 ptrbinf1.cpp            ptr2_test.cpp
 285 ptrbinf2.cpp
 286 ptrunf1.cpp
 287 ptrunf2.cpp
 288
 289 ptr_specialization.cpp  ptrspec_test.cpp
 290
 291 quiet_signal_nan.cpp    -
 292
 293 rawiter.cpp             rawiter.cpp
 294
 295 remcopy1.cpp            rm_cp_test.cpp
 296 remcpif1.cpp
 297 remif1.cpp
 298 remove1.cpp
 299 repcpif1.cpp
 300 replace0.cpp
 301 replace1.cpp
 302 replcpy1.cpp
 303 replif1.cpp
 304 revcopy1.cpp
 305 reverse1.cpp
 306
 307 reviter1.cpp            reviter_test.cpp
 308 reviter2.cpp
 309 revbit1.cpp
 310
 311 rndshuf0.cpp            rndshf_test.cpp
 312 rndshuf1.cpp
 313 rndshuf2.cpp
 314
 315 rotate0.cpp             rotate_copy.cpp
 316 rotate1.cpp
 317 rotcopy0.cpp
 318 rotcopy1.cpp
 319
 320 search0.cpp             search_test.cpp
 321 search1.cpp
 322 search2.cpp
 323
 324 seek.cpp                -
 325
 326 set.cpp                 set_test.cpp
 327
 328 setdiff0.cpp            setdiff_test.cpp
 329 setdiff1.cpp
 330 setdiff2.cpp
 331 setsymd0.cpp
 332 setsymd1.cpp
 333 setsymd2.cpp
 334
 335 setintr0.cpp            setinter_test.cpp
 336 setintr1.cpp
 337 setintr2.cpp
 338
 339 setunon0.cpp            setunion_test.cpp
 340 setunon1.cpp
 341 setunon2.cpp
 342
 343 single.cpp              -
 344
 345 slist1.cpp              slist_test.cpp
 346
 347 sort1.cpp               sort_test.cpp
 348 sort2.cpp
 349 stblsrt1.cpp
 350 stblsrt2.cpp
 351
 352 sstream1.cpp            -
 353
 354 stack1.cpp              stack_test.cpp
 355 stack2.cpp
 356
 357 strass1.cpp             -
 358
 359 string1.cpp             string_test.cpp
 360 string_mt.cpp
 361 short_string.cpp
 362
 363 swap1.cpp               swap_test.cpp
 364 swprnge1.cpp
 365
 366 times.cpp               times_test.cpp
 367
 368 trnsfrm1.cpp            transform_test.cpp
 369 trnsfrm2.cpp
 370
 371 tstdeq.cpp              -
 372
 373 ucompos1.cpp            unary_test.cpp
 374 ucompos2.cpp
 375 unegate1.cpp
 376 unegate2.cpp
 377
 378 uniqcpy1.cpp            unique_test.cpp
 379 uniqcpy2.cpp
 380 unique1.cpp
 381 unique2.cpp
 382
 383 vec.cpp                 vector_test.cpp
 384
 385 ======
 386 Status
 387 ======
 388 So far all tests from regression directory were ported except following ones:
 389
 390 iter2.cpp                       (pointless - already tested in iter1.cpp,
 391                                  see iter_test.cpp)
 392 move_constructor.cpp            (not fully tested see mvctor_test.cpp)
 393 mset1.cpp                       (moved in multiset.cpp)
 394 mset3.cpp                       (moved in multiset.cpp)
 395 mset4.cpp                       (moved in multiset.cpp)
 396 mset5.cpp                       (moved in multiset.cpp)
 397 pair1.cpp                       (pointless - already tested in pair0.cpp,
 398                                  see pair_test.cpp)
 399 pair2.cpp                       (pointless - already tested in pair0.cpp,
 400                                  see pair_test.cpp)
 401 partsrt0.cpp                    (identic w ith parsrt0.cpp - tested in
 402                                  pair_test.cpp )
 403 quiet_signal_nan.cpp
 404 revbit2.cpp                     (pointless - already tested in revbit1.cpp,
 405                                  see reviter_test.cpp )
 406 rndshuf1.cpp                    (pointless - already tested in rndshuf0.cpp,
 407                                  see rndshf_test.cpp )
 408 set1.cpp                        (moved in set.cpp)
 409 set2.cpp                        (moved in set.cpp)