/*
* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: 
* Definitions supporting character set mapping functionality.
* Supported conversion is currently only between one of a set of
* supported 8-bit character sets and Unicode.
* Author:  Pute, January 1997.
*
*/


#ifndef __CTABLE_H__
#define __CTABLE_H__
#include <stdlib.h>
#include "wide.h"

#if defined(__VC32__)
#pragma warning( disable : 4200 ) // nonstandard extension used : zero-sized array in struct/union
#endif

//
// Structures that can be easily initialised from an initialiser list.
// These are then used by the mapping classes defined underneath.
// An alternative mode of operation would be to initialise the
// classes from filed data, which would remove the need for the
// structures.
//


struct S_mapping_range
    {
    int first;
    int last;
    UTF16 mappings[32];
    };

// Intended to hold a set of contiguous mappings from characters in
// the range defined by first and last.





class Range
    {
private:
    int i_first;
    int i_last;
    // these define the range.  Arguably this could be a template class,
    // but the STL needs to be explored for this stuff.

public:

    Range ();
    Range ( int afirst, int alast );
    int count() const;                       // how many entries?
    int part_of( int avalue ) const;         // is avalue part of the range?
    int first() const;                       // return the first value
    void define ( int afirst, int alast );   // define new range.

    };



class Mapping_range
    {
private:
    Range range;
    UTF16 *mappings;

public:
    Mapping_range();
    Mapping_range( S_mapping_range *data );

    int map( unsigned char an8_bit_character, UTF16 &aUnicode_character ) const;
    //
    // If the 8-bit character is within range, the Unicode character is set
    // to its mapping, otherwise the Unicode character is unmodified.
    // The return value is true or false to indicate whether or not a
    // mapping took place.

    };


// Need to supply an escape mechanism for Unicode characters enbedded in CP1252 strings
const unsigned char UnicodeEscape = 0x81;	// indicates embedded UTF8 encoding of Unicode character


#endif // CTABLE_H not defined
// end of CTABLE.H