Utility Functions¶

Cast a pointer to the given pointer type P, and throw exception if fails.

The method calls dynamic_cast<P>(p) where P is a type you supplied; if the result is nullptr (which indicates incompatible types), an exception is thrown.

In the following example, DHCPPacket is a subclass of cMessage, and we want to assert that the message received is actually a DHCPPacket. If not, the simulation stops with an error message as the result of the exception.

References opp_typename().

A variant of check_and_cast<>() that also allows nullptr as input.

Safe integer cast: it throws an exception if in case of an overflow, i.e. when if the target type cannot represent the value in the source type. The errmsg argument will be used for the error message.

Referenced by cPar::operator char(), cValue::operator char(), cPar::operator int(), cValue::operator int(), cPar::operator long(), cValue::operator long(), cPar::operator long long(), cValue::operator long long(), cPar::operator short(), cValue::operator short(), cPar::operator unsigned char(), cValue::operator unsigned char(), cPar::operator unsigned int(), cValue::operator unsigned int(), cPar::operator unsigned long(), cValue::operator unsigned long(), cPar::operator unsigned long long(), cValue::operator unsigned long long(), cPar::operator unsigned short(), cValue::operator unsigned short(), cPar::operator=(), cPar::operator=(), cPar::operator=(), cValue::operator=(), cValue::operator=(), and cValue::operator=().

Safe integer cast: it throws an exception if in case of an overflow, i.e. when if the target type cannot represent the value in the source type. The context and errmsg arguments will be used for the error message.

Safe integer cast: it throws an exception if in case of an overflow, i.e. when if the target type cannot represent the value in the source type. The errmsg argument will be used for the error message.

Returns the name of a C++ type, correcting the quirks of various compilers.

Referenced by cValueArray::asObjectVector(), check_and_cast(), cEnum::getNameForValue(), and cEnum::resolveName().

Returns a monotonic time in nanoseconds since some unspecified starting point. This clock is not affected by discontinuous jumps in the system time (e.g. if the system administrator manually changes the clock). Note that the actual resolution (precision) of the clock may be less than nanoseconds.

Returns a monotonic time in microseconds since some unspecified starting point. This clock is not affected by discontinuous jumps in the system time (e.g. if the system administrator manually changes the clock). Note that the actual resolution (precision) of the clock may be less than microseconds.