/************************************************************************

 *

 * valcmp.h - declarations of the rw_valcmp() family of helper functions

 *

 * $Id: valcmp.h 351516 2005-12-01 23:21:09Z 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_VALCMP_H_INCLUDED

#define RW_VALCMP_H_INCLUDED

#include <testdefs.h>

#ifdef __SYMBIAN32__

#include<sstream>

#include<iterator>

#include<istream>

#endif

#define CMP_NULTERM   1   /* the first 0 terminates processing */

#define CMP_RETOFF    2   /* return offset of the first mismatch */

#define CMP_NOCASE    4   /* case-insensitive character comparison */

#define CMP_FP        8   /* safe floating pointing comparison */

_TEST_EXPORT int

rw_valcmp (const void*, const void*,

           _RWSTD_SIZE_T, _RWSTD_SIZE_T, _RWSTD_SIZE_T, int);

/**

 * Compares the contents of two arrays of objects of integral types,

 * possibly of different sizes, for equality, in a strncmp/memcmp

 * way.

 *

 * @param buf1  Pointer to an array of 0 or more objects of integral type.

 * @param buf2  Pointer to an array of 0 or more objects of integral type.

 * @param nelems  The maximum number of elements to compare.

 * @param flags  Bitmap of flags that determine how the objects are

 *               compared.

 * @return  Returns -1, 0, or +1, depending on whether the first array

 *          is less than, equal to, or greater than the second array.

 */

template <class T, class U>

inline int

rw_valcmp (const T*      buf1,

           const U*      buf2,

           _RWSTD_SIZE_T nelems,

           int           flags = 0)

{

    return rw_valcmp (buf1, buf2, nelems, sizeof (T), sizeof (U), flags);

}

/**************************************************************************/

// compares up to a maximum number of characters from the two strings

// posisbly including any embedded NULs (when the cmp_nul bit is set)

// and returns -1, 0, or +1 if the first string compares less, equal,

// or greater, respectively, than the second string, or the offset+1

// of the first mismatched character (when the cmp_off bit is set)

// or 0 otherwise

//

// rw_strncmp(s1, s2) is equivalent to a call to strcmp(s1, s2) when

// the type of s1 and s2 is char*, wcscmp(s1, s2) when the type is

// wchar_t*

//

// rw_strncmp(s1, s2, n) with (n != ~0U) is equivalent to a call to

// strncmp(s1, s2, n) or wcsncmp(s1, s2, n), respectively

//

// rw_strncmp(s1, s2, n, cmp_nul) with (n != ~0U) is equivalent to

// a call to memcmp(s1, s2, n) or wmemcmp(s1, s2, n), respectively

_TEST_EXPORT int

rw_strncmp (const char*, const char*,

            _RWSTD_SIZE_T = _RWSTD_SIZE_MAX, int = CMP_NULTERM);

#ifndef _RWSTD_NO_WCHAR_T

_TEST_EXPORT int

rw_strncmp (const char*, const wchar_t*,

            _RWSTD_SIZE_T = _RWSTD_SIZE_MAX, int = CMP_NULTERM);

_TEST_EXPORT int

rw_strncmp (const wchar_t*, const char*,

            _RWSTD_SIZE_T = _RWSTD_SIZE_MAX, int = CMP_NULTERM);

_TEST_EXPORT int

rw_strncmp (const wchar_t*, const wchar_t*,

            _RWSTD_SIZE_T = _RWSTD_SIZE_MAX, int = CMP_NULTERM);

#endif   // _RWSTD_NO_WCHAR_T

/**

 * Compares two floating point numbers for equality.

 *

 * @param x  The left hand side of the comparison.

 * @param y  The right hand side of the comparison.

 *

 * @return  Returns a negative value, 0, or a positive value, depending

 *          on whether the first number is less than, equal to, or greater

 *          than the second number. The magnitude of the returned value

 *          indicates the number of distinct values representable in

 *          the type of the number between the two arguments.

 */

_TEST_EXPORT int

rw_fltcmp (float x, float y);

/**

 * @see rw_fltcmp.

 */

_TEST_EXPORT int

rw_dblcmp (double x, double y);

#ifndef _RWSTD_NO_LONG_DOUBLE

/**

 * @see rw_fltcmp.

 */

_TEST_EXPORT int

rw_ldblcmp (long double x, long double y);

#endif   // _RWSTD_NO_LONG_DOUBLE

#ifdef __SYMBIAN32__

_TEST_EXPORT int 

 rw_strcmp (std::basic_string<char>& x ,long double y);

 _TEST_EXPORT int 

 rw_strcmp (std::basic_string<wchar_t>& x ,long double y);

 _TEST_EXPORT

 void WCtoC(const wchar_t *wstr, int len, char* str);

 #endif

/**************************************************************************/

/**

 * Compares two values of the same type for equality.

 *

 * @param x  The left hand side of the comparison.

 * @param y  The right hand side of the comparison.

 *

 * @return  Returns 1 if the the values are the same, 0 otherwise.

 */

template <class T>

inline int rw_equal (T x, T y)

{

    return x == y;

}

/**

 * @see rw_equal.

 */

inline int rw_equal (float x, float y)

{

    return 0 == rw_fltcmp (x, y);

}

/**

 * @see rw_equal.

 */

inline int rw_equal (double x, double y)

{

    return 0 == rw_dblcmp (x, y);

}

#ifndef _RWSTD_NO_LONG_DOUBLE

/**

 * @see rw_equal.

 */

inline int rw_equal (long double x, long double y)

{

    return 0 == rw_ldblcmp (x, y);

}

#endif   // _RWSTD_NO_LONG_DOUBLE

#endif   // RW_VALCMP_H_INCLUDED