diff -r 000000000000 -r bde4ae8d615e os/ossrv/stdcpp/tsrc/Stdcpp_test/stdcxx/include/driver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/os/ossrv/stdcpp/tsrc/Stdcpp_test/stdcxx/include/driver.h Fri Jun 15 03:10:57 2012 +0200 @@ -0,0 +1,154 @@ +/************************************************************************ + * + * driver.h - testsuite driver declarations + * + * $Id: driver.h 287304 2005-09-15 00:41:16Z sebor $ + * + *************************************************************************** + * + * Copyright (c) 1994-2005 Quovadx, Inc., acting through its Rogue Wave + * Software division. Licensed under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance with the + * License. You may obtain a copy of the License at + * http://www.apache.org/licenses/LICENSE-2.0. Unless required by + * applicable law or agreed to in writing, software distributed under + * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + * CONDITIONS OF ANY KIND, either express or implied. See the License + * for the specific language governing permissions and limitations under + * the License. + * + **************************************************************************/ + +#ifndef RW_DRIVER_H_INCLUDED +#define RW_DRIVER_H_INCLUDED + +#include // for test config macros +extern int failures; + +/** + * Initializes the test driver, passes program arguments to it, processes + * command line arguments, any arguments specified in the environment + * variable RWSTD_TESTOPTS, and if successful, invokes the program-supplied + * callback function. + * + * @param argc The number of non-null elements in the argv array. + * @param argv A null-terminated array of command line arguments. + * If (argc == 0) the argument may be null. + * @param filename The name of the source file name, typically + * the __FILE__ macro. The argument may be null. + * @param clause The clause exercised by the program, such as + * lib.basic.string. The argument may be null. + * @param comment An optional comment describing in more detail + * the functionality of the program. The argument may be null. + * @param testfun A pointer to a callback function to call by the + * driver after successful initialization. The argument must + * not be null. + * @param optspec An optional character string describing command + * line options accepted by the program. The argument may + * be null. + * @param ... Optional list of handlers of command line options + * corresponding to the optspec. + * + * @return If initialization is successful, returns the value returned + * by the callback function. Otherwise, returns the non-zero + * value returned by the last initialization function or + * command line option handler. + * + * After the driver has been initialzied the user-supplied callback function + * may call any of the driver diagnostic functions to record and perhaps also + * issue diagnostic messages of varying severity. + * + * There are 10 levels of severity with 0 being the lowest and 9 the highest. + * Diagnostics of all levels of severity come in two states: active and + * inactive. All diagnostics are recorded but normally only active diagnostics + * of severity 4 or above are issued. It is possible to cause diagnostics of + * lower severity levels to be issued via a command line option to the driver. + * Choosing to issue severity 0 diagnostics has the effect of issuing inactive + * diagnostics. + * + * After the callback function returns the driver displays a summary detailing + * the number of recorded diagnostics in each of the two states (active and + * inactive). + * + */ +_TEST_EXPORT int +rw_test (int argc, + char* argv[], + const char* filename, + const char* clause, + const char* comment, + int (*testfun)(int, char**), + const char* optspec, + ...); + +/** + * Records and optionally issues a diagnostic of the highest severity 9. + * + * @param expr A zero value denoting an active diagnostic or any non-zero + * vaue denoting an inactive diagnostic. + * @param filename An optional name of the file invoking the function. + * The argument may be null. + * @param line When positive, denotes the line number of the location + * relevant to the diagnostic. Negative values are ignored. + * @param fmtspec A printf format specifier (with extensions) used + * to format the text of the diagnostic. + * @param ... Optional list of values to format. + * + * @return Returns the value of expr passed to it. + * + * Every diagnostic is recorded but only active diagnostics may be issued, + * depending on the setting of the diagnosable severity. The value of the + * first argument determines whether a diagnostc is active or inactive. + * Unlike the remaining diagnostic functions, rw_fatal doesn't return to + * the caller when expr is 0 (i.e., when the diagnostic is active). + * Instead, it causes the driver the exit the process with the staus equal + * to 9, the severity of the diagnostic. + */ +_TEST_EXPORT int +rw_fatal (int expr, + const char* filename, + int line, + const char* fmtspec, + ...); + +/** + * Records and optionally issues a diagnostic of severity 8. + * + * @see #rw_fatal + */ +_TEST_EXPORT int +rw_error (int, const char*, int, const char*, ...); + +/** + * Records and optionally issues a diagnostic of severity 7. + * + * @see #rw_fatal + */ +_TEST_EXPORT int +rw_assert (int, const char*, int, const char*, ...); + +/** + * Records and optionally issues a diagnostic of severity 5. + * + * @see #rw_fatal + */ +_TEST_EXPORT int +rw_warn (int, const char*, int, const char*, ...); + +/** + * Records and optionally issues a diagnostic of severity 2. + * + * @see #rw_fatal + */ +_TEST_EXPORT int +rw_note (int, const char*, int, const char*, ...); + +/** + * Records and optionally issues a diagnostic of severity 1. + * + * @see #rw_fatal + */ +_TEST_EXPORT int +rw_info (int, const char*, int, const char*, ...); + +#endif // RW_DRIVER_H_INCLUDED