sc_uint.h

Go to the documentation of this file.

/*****************************************************************************
 
  Licensed to Accellera Systems Initiative Inc. (Accellera) under one or
  more contributor license agreements.  See the NOTICE file distributed
  with this work for additional information regarding copyright ownership.
  Accellera licenses this file to you 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.
 
 *****************************************************************************/
 
/*****************************************************************************
 
  sc_uint.h -- A sc_uint is an unsigned integer whose length is less than the
               machine's native integer length. We provide two implementations
               (i) sc_uint with length between 1 - 64, and (ii) sc_uint with
               length between 1 - 32. Implementation (i) is the default
               implementation, while implementation (ii) can be used only if
               compiled with -D_32BIT_. Unlike arbitrary precision, arithmetic
               and bitwise operations are performed using the native types
               (hence capped at 32/64 bits). The sc_uint integer is useful
               when the user does not need arbitrary precision and the
               performance is superior to sc_bigint/sc_biguint.
 
  Original Author: Amit Rao, Synopsys, Inc.
 
 *****************************************************************************/
 
/*****************************************************************************
 
  MODIFICATION LOG - modifiers, enter your name, affiliation, date and
  changes you are making here.
 
      Name, Affiliation, Date: Ali Dasdan, Synopsys, Inc.
  Description of Modification: - Resolved ambiguity with sc_(un)signed.
                               - Merged the code for 64- and 32-bit versions
                                 via the constants in sc_nbdefs.h.
                               - Eliminated redundant file inclusions.
 
      Name, Affiliation, Date:
  Description of Modification:
 
 *****************************************************************************/
 
// $Log: sc_uint.h,v $
// Revision 1.2  2011/02/18 20:19:15  acg
//  Andy Goodrich: updating Copyright notice.
//
// Revision 1.1.1.1  2006/12/15 20:20:05  acg
// SystemC 2.3
//
// Revision 1.3  2006/01/13 18:49:32  acg
// Added $Log command so that CVS check in comments are reproduced in the
// source.
//
 
#ifndef SC_UINT_H
#define SC_UINT_H
 
 
#include "sysc/datatypes/int/sc_uint_base.h"
 
 
namespace sc_dt
{
 
// classes defined in this module
template <int W> class sc_uint;
 
 
// ----------------------------------------------------------------------------
//  CLASS TEMPLATE : sc_uint<W>
//
//  Template class sc_uint<W> is the interface that the user sees. It
//  is derived from sc_uint_base and most of its methods are just
//  wrappers that call the corresponding method in the parent
//  class. Note that the length of sc_uint datatype is specified as a
//  template parameter.
// ----------------------------------------------------------------------------
 
template <int W>
class sc_uint
    : public sc_uint_base
{
public:
 
    // assignment with sign extensions
    
    void assign( uint_type value )
    {   
        m_val = value & ( ~UINT_ZERO >> (SC_INTWIDTH-W) );
    }
 
    // constructors
 
    sc_uint()
        : sc_uint_base( W )
        {}
 
    sc_uint( uint_type v )
        : sc_uint_base( W )
        { assign(v); }
 
    sc_uint( const sc_uint<W>& a )
        : sc_uint_base( a )
        {}
 
    sc_uint( const sc_uint_base& a )
        : sc_uint_base( W )
        { assign( a ); }
 
    sc_uint( const sc_uint_subref_r& a )
        : sc_uint_base( W )
        { assign( a ); }
 
    template< class T >
    sc_uint( const sc_generic_base<T>& a )
        : sc_uint_base( W )
        { assign( a->to_uint64() ); }
 
    template<int WO>
    sc_uint( const sc_bigint<WO>& a )
        : sc_uint_base( W )
        { assign( a.to_uint64() ); }
 
    template<int WO>
    sc_uint( const sc_biguint<WO>& a )
        : sc_uint_base( W )
        { assign( a.to_uint64() ); }
 
    sc_uint( const sc_signed& a )
        : sc_uint_base( W )
        { assign( a.to_uint64() ); }
 
    sc_uint( const sc_unsigned& a )
        : sc_uint_base( W )
        { assign( a.to_uint64() ); }
 
#ifdef SC_INCLUDE_FX
 
    explicit sc_uint( const sc_fxval& a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
    explicit sc_uint( const sc_fxval_fast& a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
    explicit sc_uint( const sc_fxnum& a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
    explicit sc_uint( const sc_fxnum_fast& a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
#endif
 
    sc_uint( const sc_bv_base& a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
    sc_uint( const sc_lv_base& a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
    sc_uint( const char* a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
    sc_uint( unsigned long a )
        : sc_uint_base( W )
        { assign( a ); }
 
    sc_uint( long a )
        : sc_uint_base( W )
        { assign( a ); }
 
    sc_uint( unsigned int a )
        : sc_uint_base( W )
        { assign( a ); }
 
    sc_uint( int a )
        : sc_uint_base( W )
        { assign( a ); }
 
    sc_uint( int64 a )
        : sc_uint_base( W )
        { assign( a ); }
 
    sc_uint( double a )
        : sc_uint_base( W )
        { sc_uint_base::operator = ( a ); }
 
 
    // assignment operators
 
    sc_uint<W>& operator = ( uint_type v )
        { sc_uint_base::operator = ( v ); return *this; }
 
    sc_uint<W>& operator = ( const sc_uint_base& a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_uint_subref_r& a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_uint<W>& a )
        { m_val = a.m_val; return *this; }
 
    template<class T>
    sc_uint<W>& operator = ( const sc_generic_base<T>& a )
        { assign( a->to_uint64() ); return *this; }
 
    sc_uint<W>& operator = ( const sc_signed& a )
        { assign( a.to_uint64() ); return *this; }
 
    template<int W1>
    inline
    const sc_uint<W>& operator = ( const sc_bigint<W1>& a );
 
    template<int W1>
    inline
    const sc_uint<W>& operator = ( const sc_biguint<W1>& a );
 
    sc_uint<W>& operator = ( const sc_unsigned& a )
        { assign( a.to_uint64() ); return *this; }
 
    sc_uint<W>& operator = ( const sc_signed_subref_r& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_unsigned_subref_r& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
#ifdef SC_INCLUDE_FX
 
    sc_uint<W>& operator = ( const sc_fxval& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_fxval_fast& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_fxnum& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_fxnum_fast& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
#endif
 
    sc_uint<W>& operator = ( const sc_bv_base& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( const sc_lv_base& a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( const char* a )
        { sc_uint_base::operator = ( a ); return *this; }
 
    sc_uint<W>& operator = ( unsigned long a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( long a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( unsigned int a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( int a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( int64 a )
        { assign( a ); return *this; }
 
    sc_uint<W>& operator = ( double a )
        { sc_uint_base::operator = ( a ); return *this; }
 
 
    // arithmetic assignment operators
 
    sc_uint<W>& operator += ( uint_type v )
        { sc_uint_base::operator += ( v ); return *this; }
 
    sc_uint<W>& operator -= ( uint_type v )
        { sc_uint_base::operator -= ( v ); return *this; }
 
    sc_uint<W>& operator *= ( uint_type v )
        { sc_uint_base::operator *= ( v ); return *this; }
 
    sc_uint<W>& operator /= ( uint_type v )
        { sc_uint_base::operator /= ( v ); return *this; }
 
    sc_uint<W>& operator %= ( uint_type v )
        { sc_uint_base::operator %= ( v ); return *this; }
 
  
    // bitwise assignment operators
 
    sc_uint<W>& operator &= ( uint_type v )
        { sc_uint_base::operator &= ( v ); return *this; }
 
    sc_uint<W>& operator |= ( uint_type v )
        { sc_uint_base::operator |= ( v ); return *this; }
 
    sc_uint<W>& operator ^= ( uint_type v )
        { sc_uint_base::operator ^= ( v ); return *this; }
 
 
    sc_uint<W>& operator <<= ( uint_type v )
        { sc_uint_base::operator <<= ( v ); return *this; }
 
    sc_uint<W>& operator >>= ( uint_type v )
        { sc_uint_base::operator >>= ( v ); return *this; }
 
 
    // prefix and postfix increment and decrement operators
 
    sc_uint<W>& operator ++ () // prefix
        { sc_uint_base::operator ++ (); return *this; }
 
    sc_uint<W> operator ++ ( int ) // postfix
        { return sc_uint<W>( sc_uint_base::operator ++ ( 0 ) ); }
 
    sc_uint<W>& operator -- () // prefix
        { sc_uint_base::operator -- (); return *this; }
 
    sc_uint<W> operator -- ( int ) // postfix
        { return sc_uint<W>( sc_uint_base::operator -- ( 0 ) ); }
};
 
} // namespace sc_dt
 
 
#endif
 
// Taf!