String conversion Functions

String conversion functions. More...

Collaboration diagram for String conversion Functions:

Functions

Bool Murl::Util::StringToBool (const String &inputString, Bool &value)
 Convert a decimal string to a bool value. More...
 
Bool Murl::Util::StringToUInt64 (const String &inputString, UInt64 &value)
 Convert a decimal string to a UInt64 value. More...
 
Bool Murl::Util::StringToSInt64 (const String &inputString, SInt64 &value)
 Convert a decimal string to a SInt64 value. More...
 
Bool Murl::Util::StringToUInt32 (const String &inputString, UInt32 &value)
 Convert a decimal string to a UInt32 value. More...
 
Bool Murl::Util::StringToSInt32 (const String &inputString, SInt32 &value)
 Convert a decimal string to a SInt32 value. More...
 
Bool Murl::Util::StringToDouble (const String &inputString, Double &value)
 Convert a string to a Double value. More...
 
Bool Murl::Util::StringToFloat (const String &inputString, Float &value)
 Convert a string to a Float value. More...
 
Bool Murl::Util::StringToColor (const String &inputString, Color &value, Color::StringFormat &format)
 Convert a string to a color object. More...
 
Bool Murl::Util::StringToColor (const String &inputString, Color &value, Bool &hasType)
 Convert a string to a color object. More...
 
Bool Murl::Util::StringToColor (const String &inputString, Color &value)
 Convert a string to a color object. More...
 
Bool Murl::Util::StringToColorComponent (const String &inputString, Float &value, Color::StringFormat &format)
 Convert a string to a Float color component. More...
 
Bool Murl::Util::StringToColorComponent (const String &inputString, Float &value, Bool &hasType)
 Convert a string to a Float color component. More...
 
Bool Murl::Util::StringToColorComponent (const String &inputString, Float &value)
 Convert a string to a Float color component. More...
 
Bool Murl::Util::HexStringToUInt64 (const String &inputString, UInt64 &value)
 Convert a hexadecimal string to a UInt64 value. More...
 
Bool Murl::Util::HexStringToUInt32 (const String &inputString, UInt32 &value)
 Convert a hexadecimal string to a UInt32 value. More...
 
Bool Murl::Util::AngleStringToDouble (const String &inputString, Double &value, Bool &hasUnit)
 Convert an angle string to a Double value. More...
 
Bool Murl::Util::StringToBoolArray (const String &inputString, Char delimiter, BoolArray &values)
 Convert a string to a Bool array using a given delimiter. More...
 
Bool Murl::Util::StringToUInt64Array (const String &inputString, Char delimiter, UInt64Array &values)
 Convert a string to a UInt64 array using a given delimiter. More...
 
Bool Murl::Util::StringToSInt64Array (const String &inputString, Char delimiter, SInt64Array &values)
 Convert a string to a SInt64 array using a given delimiter. More...
 
Bool Murl::Util::StringToUInt32Array (const String &inputString, Char delimiter, UInt32Array &values)
 Convert a string to a UInt32 array using a given delimiter. More...
 
Bool Murl::Util::StringToSInt32Array (const String &inputString, Char delimiter, SInt32Array &values)
 Convert a string to a SInt32 array using a given delimiter. More...
 
Bool Murl::Util::StringToDoubleArray (const String &inputString, Char delimiter, DoubleArray &values)
 Convert a string to a Double array using a given delimiter. More...
 
Bool Murl::Util::StringToFloatArray (const String &inputString, Char delimiter, FloatArray &values)
 Convert a string to a Float array using a given delimiter. More...
 
UInt32 Murl::Util::StringToBoolArray (const String &inputString, Char delimiter, Bool *values, UInt32 numValues)
 Convert a string to a Bool array using a given delimiter. More...
 
UInt32 Murl::Util::StringToUInt64Array (const String &inputString, Char delimiter, UInt64 *values, UInt32 numValues)
 Convert a string to a UInt64 array using a given delimiter. More...
 
UInt32 Murl::Util::StringToSInt64Array (const String &inputString, Char delimiter, SInt64 *values, UInt32 numValues)
 Convert a string to a SInt64 array using a given delimiter. More...
 
UInt32 Murl::Util::StringToUInt32Array (const String &inputString, Char delimiter, UInt32 *values, UInt32 numValues)
 Convert a string to a UInt32 array using a given delimiter. More...
 
UInt32 Murl::Util::StringToSInt32Array (const String &inputString, Char delimiter, SInt32 *values, UInt32 numValues)
 Convert a string to a SInt32 array using a given delimiter. More...
 
UInt32 Murl::Util::StringToDoubleArray (const String &inputString, Char delimiter, Double *values, UInt32 numValues)
 Convert a string to a Double array using a given delimiter. More...
 
UInt32 Murl::Util::StringToFloatArray (const String &inputString, Char delimiter, Float *values, UInt32 numValues)
 Convert a string to a Float array using a given delimiter. More...
 
String Murl::Util::UInt64ToString (UInt64 inputValue)
 Convert a UInt64 value to a string. More...
 
String Murl::Util::SInt64ToString (SInt64 inputValue)
 Convert a SInt64 value to a string. More...
 
String Murl::Util::UInt32ToString (UInt32 inputValue)
 Convert a UInt32 value to a string. More...
 
String Murl::Util::SInt32ToString (SInt32 inputValue)
 Convert a SInt32 value to a string. More...
 
String Murl::Util::DoubleToString (Double inputValue)
 Convert a Double value to a string. More...
 
String Murl::Util::ColorToString (const Color &inputValue)
 Convert a Color object to a string in float representation. More...
 
String Murl::Util::ColorToString (const Color &inputValue, Color::StringFormat colorStringFormat)
 Convert a Color object to a string using a given color string format. More...
 
String Murl::Util::UInt64ToString (UInt64 inputValue, const String &format)
 Convert a UInt64 value to a string using a format string. More...
 
String Murl::Util::SInt64ToString (SInt64 inputValue, const String &format)
 Convert a SInt64 value to a string using a format string. More...
 
String Murl::Util::UInt32ToString (UInt32 inputValue, const String &format)
 Convert a UInt32 value to a string using a format string. More...
 
String Murl::Util::SInt32ToString (SInt32 inputValue, const String &format)
 Convert a SInt32 value to a string using a format string. More...
 
String Murl::Util::DoubleToString (Double inputValue, const String &format)
 Convert a Double value to a string using a format string. More...
 
String Murl::Util::ColorToString (const Color &inputValue, const String &format)
 Convert a Color object to a string in float representation. More...
 
String Murl::Util::ColorToString (const Color &inputValue, Color::StringFormat colorStringFormat, const String &format)
 Convert a Color object to a string using a given color string format. More...
 
String Murl::Util::BoolToString (Bool inputValue)
 Convert a Bool value to a string. More...
 
String Murl::Util::TimeToString (const System::Time &inputValue)
 Convert a time value to a string. More...
 
String Murl::Util::TimeToString (const System::Time &inputValue, const String &separator)
 Convert a time value to a string using a separator. More...
 
Bool Murl::Util::Utf8ToWChar (const Char *inputBytes, UInt32 &numToSkip, WChar *outputValues, UInt32 &numValues)
 Convert an UTF8 character sequence to a wide-character. More...
 
Bool Murl::Util::WCharToUtf8 (const WChar *inputValues, UInt32 &numToSkip, Char *outputBytes, UInt32 &numBytes)
 Convert a wide-character to an UTF8 character sequence. More...
 
Bool Murl::Util::Utf8ToUtf16 (const Char *inputBytes, UInt32 &numToSkip, UInt16 *outputValues, UInt32 &numValues)
 Convert an UTF8 character sequence to an UTF16 character. More...
 
Bool Murl::Util::Utf16ToUtf8 (const UInt16 *inputValues, UInt32 &numToSkip, Char *outputBytes, UInt32 &numBytes)
 Convert an UTF16 character to an UTF8 character sequence. More...
 
Bool Murl::Util::Utf8ToUtf32 (const Char *inputBytes, UInt32 &outputValue, UInt32 &numToSkip)
 Convert an UTF8 character sequence to an UTF32 character. More...
 
Bool Murl::Util::Utf32ToUtf8 (UInt32 inputValue, Char *outputBytes, UInt32 &numBytes)
 Convert an UTF32 character to an UTF8 character sequence. More...
 
String Murl::Util::ValueToString (UInt64 inputValue)
 ValueToString overload for UInt64ToString() method.
 
String Murl::Util::ValueToString (SInt64 inputValue)
 ValueToString overload for SInt64ToString() method.
 
String Murl::Util::ValueToString (UInt32 inputValue)
 ValueToString overload for UInt32ToString() method.
 
String Murl::Util::ValueToString (SInt32 inputValue)
 ValueToString overload for SInt32ToString() method.
 
String Murl::Util::ValueToString (Double inputValue)
 ValueToString overload for DoubleToString() method.
 
String Murl::Util::ValueToString (const Color &inputValue)
 ValueToString overload for ColorToString() method.
 
String Murl::Util::ValueToString (Bool inputValue)
 ValueToString overload for BoolToString() method.
 
String Murl::Util::ValueToString (const System::Time &inputValue)
 ValueToString overload for TimeToString() method.
 

Detailed Description

String conversion functions.

Function Documentation

◆ StringToBool()

Bool Murl::Util::StringToBool ( const String inputString,
Bool value 
)

Convert a decimal string to a bool value.

The conversion ignores case, leading and trailing whitespaces.

  • "true", "on", "yes", "1" or any integer not equal to zero for true.
  • "false", "off", "no" or "0" for false.
    Parameters
    inputStringThe string to convert.
    valueThe return value.
    Returns
    true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ StringToUInt64()

Bool Murl::Util::StringToUInt64 ( const String inputString,
UInt64 value 
)

Convert a decimal string to a UInt64 value.

The conversion ignores leading and trailing whitespaces.

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ StringToSInt64()

Bool Murl::Util::StringToSInt64 ( const String inputString,
SInt64 value 
)

Convert a decimal string to a SInt64 value.

The conversion ignores leading and trailing whitespaces.

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ StringToUInt32()

Bool Murl::Util::StringToUInt32 ( const String inputString,
UInt32 value 
)

Convert a decimal string to a UInt32 value.

The conversion ignores leading and trailing whitespaces.

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

Referenced by Murl::Graph::NodeArrayTarget< ObjectType, MIN_NUMBER_OF_NODES, MAX_NUMBER_OF_NODES, RESERVED_NUMBER_OF_NODES >::DeserializeNodeId(), and Murl::Graph::ResourceArrayTarget< ObjectType, MIN_NUMBER_OF_RESOURCES, MAX_NUMBER_OF_RESOURCES, RESERVED_NUMBER_OF_RESOURCES >::DeserializeResourceId().

◆ StringToSInt32()

Bool Murl::Util::StringToSInt32 ( const String inputString,
SInt32 value 
)

Convert a decimal string to a SInt32 value.

The conversion ignores leading and trailing whitespaces.

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ StringToDouble()

Bool Murl::Util::StringToDouble ( const String inputString,
Double value 
)

Convert a string to a Double value.

The conversion ignores leading and trailing whitespaces. The decimal separator is the '.' character (locale independent).

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ StringToFloat()

Bool Murl::Util::StringToFloat ( const String inputString,
Float value 
)

Convert a string to a Float value.

The conversion ignores leading and trailing whitespaces. The decimal separator is the '.' character (locale independent).

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ StringToColor() [1/3]

Bool Murl::Util::StringToColor ( const String inputString,
Color value,
Color::StringFormat format 
)

Convert a string to a color object.

The conversion ignores case, leading and trailing whitespaces. A color value can be specified by comma separated component values or a single 32 bit hex value:

  • "RR, GG, BB, AA" The alpha value is optional, the default alpha is 1.0.
  • "AARRGGBBh", e.g. "ff7f3f1fh".
  • "RRGGBBh", e.g. "7f3f1fh", alpha is set to 1.0.

The component format specifiers are:

  • f float component range is [0.0 .. 1.0], e.g. "0.5f, 0.25f, 0.125f, 1.0f".
  • i integer component range is [0 .. 255], e.g. "127i, 63i, 31i, 255i".
  • h hex component range is [0x00 .. 0xff], e.g. "7fh, 3fh, 1fh, ffh".

If a component has no format specifier the float format is assumed. If the string has only one component and the format specifier is missing, the "AARRGGBBh" format is assumed.

Parameters
inputStringThe string to convert.
valueThe color return value.
formatThis return value is set to the color string format recognized during conversion, or Color::STRING_FORMAT_UNKNOWN if failed. If different format specifiers are given, Color::STRING_FORMAT_MIXED is returned, and if not all of the given components have an explicit specifier, Color::STRING_FORMAT_INCOMPLETE is returned.
Returns
true if conversion was successful. If the conversion failed the 'value' return value is unchanged and false is returned.

◆ StringToColor() [2/3]

Bool Murl::Util::StringToColor ( const String inputString,
Color value,
Bool hasType 
)

Convert a string to a color object.

See StringToColor(const String& inputString, Color& value, Color::StringFormat& format).

Parameters
inputStringThe string to convert.
valueThe color return value.
hasTypeThis return value is set to false if any format specifier is missing.
Returns
true if conversion was successful, if the conversion failed the 'value' return value is unchanged and false is returned.

◆ StringToColor() [3/3]

Bool Murl::Util::StringToColor ( const String inputString,
Color value 
)

Convert a string to a color object.

See StringToColor(const String& inputString, Color& value, Color::StringFormat& format).

Parameters
inputStringThe string to convert.
valueThe color return value.
Returns
true if conversion was successful, if the conversion failed the 'value' return value is unchanged and false is returned.

◆ StringToColorComponent() [1/3]

Bool Murl::Util::StringToColorComponent ( const String inputString,
Float value,
Color::StringFormat format 
)

Convert a string to a Float color component.

The conversion ignores case, leading and trailing whitespaces. The component format specifiers are:

  • f float component range is [0.0 .. 1.0], e.g. "0.5f".
  • i integer component range is [0 .. 255], e.g. "127i".
  • h hex component range is [0x00 .. 0xff], e.g. "7fh".

If the format specifier is missing the float format is assumed.

Parameters
inputStringThe string to convert.
valueThe color component return value.
formatThis return value is set to the color string format recognized during conversion, or Color::STRING_FORMAT_UNKNOWN if failed. If different format specifiers are given, Color::STRING_FORMAT_MIXED is returned, and if not all of the given components have an explicit specifier, Color::STRING_FORMAT_INCOMPLETE is returned.
Returns
true if conversion was successful, if the conversion failed the 'value' return value is unchanged and false is returned.

◆ StringToColorComponent() [2/3]

Bool Murl::Util::StringToColorComponent ( const String inputString,
Float value,
Bool hasType 
)

Convert a string to a Float color component.

See StringToColorComponent(const String& inputString, Float& value, Color::StringFormat& format).

Parameters
inputStringThe string to convert.
valueThe color component return value.
hasTypeThis return value is set to false if any format specifier is missing.
Returns
true if conversion was successful, if the conversion failed the 'value' return value is unchanged and false is returned.

◆ StringToColorComponent() [3/3]

Bool Murl::Util::StringToColorComponent ( const String inputString,
Float value 
)

Convert a string to a Float color component.

See StringToColorComponent(const String& inputString, Float& value, Color::StringFormat& format).

Parameters
inputStringThe string to convert.
valueThe color component return value.
Returns
true if conversion was successful, if the conversion failed the 'value' return value is unchanged and false is returned.

◆ HexStringToUInt64()

Bool Murl::Util::HexStringToUInt64 ( const String inputString,
UInt64 value 
)

Convert a hexadecimal string to a UInt64 value.

The conversion ignores leading and trailing whitespaces.

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ HexStringToUInt32()

Bool Murl::Util::HexStringToUInt32 ( const String inputString,
UInt32 value 
)

Convert a hexadecimal string to a UInt32 value.

The conversion ignores leading and trailing whitespaces.

Parameters
inputStringThe string to convert.
valueThe return value.
Returns
true if conversion was successful, if the conversion failed the value parameter is unchanged and false is returned.

◆ AngleStringToDouble()

Bool Murl::Util::AngleStringToDouble ( const String inputString,
Double value,
Bool hasUnit 
)

Convert an angle string to a Double value.

The conversion ignores case, leading and trailing whitespaces. An angle string can specify the unit:

  • deg or d for degress, e.g. "180 deg"
  • rad or r for radiants, e.g. "3.1415 rad"

If the unit specifier is missing the radiants unit is assumed.

Parameters
inputStringThe string to convert.
valueThe angle return value.
hasUnitThis return value is set to false if the unit specifier is missing.
Returns
true if conversion was successful, if the conversion failed the 'value' return value is unchanged and false is returned.

◆ StringToBoolArray() [1/2]

Bool Murl::Util::StringToBoolArray ( const String inputString,
Char  delimiter,
BoolArray values 
)

Convert a string to a Bool array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToUInt64Array() [1/2]

Bool Murl::Util::StringToUInt64Array ( const String inputString,
Char  delimiter,
UInt64Array values 
)

Convert a string to a UInt64 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToSInt64Array() [1/2]

Bool Murl::Util::StringToSInt64Array ( const String inputString,
Char  delimiter,
SInt64Array values 
)

Convert a string to a SInt64 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToUInt32Array() [1/2]

Bool Murl::Util::StringToUInt32Array ( const String inputString,
Char  delimiter,
UInt32Array values 
)

Convert a string to a UInt32 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToSInt32Array() [1/2]

Bool Murl::Util::StringToSInt32Array ( const String inputString,
Char  delimiter,
SInt32Array values 
)

Convert a string to a SInt32 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToDoubleArray() [1/2]

Bool Murl::Util::StringToDoubleArray ( const String inputString,
Char  delimiter,
DoubleArray values 
)

Convert a string to a Double array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToFloatArray() [1/2]

Bool Murl::Util::StringToFloatArray ( const String inputString,
Char  delimiter,
FloatArray values 
)

Convert a string to a Float array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesThe return values array.
Returns
true if successful, false if converting the values failed.

◆ StringToBoolArray() [2/2]

UInt32 Murl::Util::StringToBoolArray ( const String inputString,
Char  delimiter,
Bool values,
UInt32  numValues 
)

Convert a string to a Bool array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ StringToUInt64Array() [2/2]

UInt32 Murl::Util::StringToUInt64Array ( const String inputString,
Char  delimiter,
UInt64 values,
UInt32  numValues 
)

Convert a string to a UInt64 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ StringToSInt64Array() [2/2]

UInt32 Murl::Util::StringToSInt64Array ( const String inputString,
Char  delimiter,
SInt64 values,
UInt32  numValues 
)

Convert a string to a SInt64 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ StringToUInt32Array() [2/2]

UInt32 Murl::Util::StringToUInt32Array ( const String inputString,
Char  delimiter,
UInt32 values,
UInt32  numValues 
)

Convert a string to a UInt32 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ StringToSInt32Array() [2/2]

UInt32 Murl::Util::StringToSInt32Array ( const String inputString,
Char  delimiter,
SInt32 values,
UInt32  numValues 
)

Convert a string to a SInt32 array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ StringToDoubleArray() [2/2]

UInt32 Murl::Util::StringToDoubleArray ( const String inputString,
Char  delimiter,
Double values,
UInt32  numValues 
)

Convert a string to a Double array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ StringToFloatArray() [2/2]

UInt32 Murl::Util::StringToFloatArray ( const String inputString,
Char  delimiter,
Float values,
UInt32  numValues 
)

Convert a string to a Float array using a given delimiter.

Parameters
inputStringThe string to convert.
delimiterThe delimiter character.
valuesPointer to the return values array.
numValuesThe number of elements to write into the values array.
Returns
The number of elements written to the values array or zero if the conversion failed.

◆ UInt64ToString() [1/2]

String Murl::Util::UInt64ToString ( UInt64  inputValue)

Convert a UInt64 value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string.

◆ SInt64ToString() [1/2]

String Murl::Util::SInt64ToString ( SInt64  inputValue)

Convert a SInt64 value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string.

◆ UInt32ToString() [1/2]

String Murl::Util::UInt32ToString ( UInt32  inputValue)

Convert a UInt32 value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string.

Referenced by Murl::Logic::GraphInstanceObjects< InstanceObjectType >::Init().

◆ SInt32ToString() [1/2]

String Murl::Util::SInt32ToString ( SInt32  inputValue)

Convert a SInt32 value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string.

◆ DoubleToString() [1/2]

String Murl::Util::DoubleToString ( Double  inputValue)

Convert a Double value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string.

◆ ColorToString() [1/4]

String Murl::Util::ColorToString ( const Color inputValue)

Convert a Color object to a string in float representation.

Parameters
inputValueThe color to convert.
Returns
The converted string.

◆ ColorToString() [2/4]

String Murl::Util::ColorToString ( const Color inputValue,
Color::StringFormat  colorStringFormat 
)

Convert a Color object to a string using a given color string format.

Parameters
inputValueThe color to convert.
colorStringFormatThe color string format.
Returns
The converted string.

◆ UInt64ToString() [2/2]

String Murl::Util::UInt64ToString ( UInt64  inputValue,
const String format 
)

Convert a UInt64 value to a string using a format string.

Parameters
inputValueThe value to convert.
formatThe format string should contain "%llu".
Returns
The converted string.

Referenced by Murl::Util::ValueToString().

◆ SInt64ToString() [2/2]

String Murl::Util::SInt64ToString ( SInt64  inputValue,
const String format 
)

Convert a SInt64 value to a string using a format string.

Parameters
inputValueThe value to convert.
formatThe format string should contain "%lld".
Returns
The converted string.

Referenced by Murl::Util::ValueToString().

◆ UInt32ToString() [2/2]

String Murl::Util::UInt32ToString ( UInt32  inputValue,
const String format 
)

Convert a UInt32 value to a string using a format string.

Parameters
inputValueThe value to convert.
formatThe format string should contain "%u".
Returns
The converted string.

Referenced by Murl::Util::ValueToString().

◆ SInt32ToString() [2/2]

String Murl::Util::SInt32ToString ( SInt32  inputValue,
const String format 
)

Convert a SInt32 value to a string using a format string.

Parameters
inputValueThe value to convert.
formatThe format string should contain "%d".
Returns
The converted string.

Referenced by Murl::Util::ValueToString().

◆ DoubleToString() [2/2]

String Murl::Util::DoubleToString ( Double  inputValue,
const String format 
)

Convert a Double value to a string using a format string.

Parameters
inputValueThe value to convert.
formatThe format string should contain "%f" or "%g".
Returns
The converted string.

Referenced by Murl::Util::ValueToString().

◆ ColorToString() [3/4]

String Murl::Util::ColorToString ( const Color inputValue,
const String format 
)

Convert a Color object to a string in float representation.

Parameters
inputValueThe color to convert.
formatThe format string should contain "%f" or "%g".
Returns
The converted string.

◆ ColorToString() [4/4]

String Murl::Util::ColorToString ( const Color inputValue,
Color::StringFormat  colorStringFormat,
const String format 
)

Convert a Color object to a string using a given color string format.

Parameters
inputValueThe color to convert.
colorStringFormatThe color string format
formatThe format string should contain "%f" or "%g" for Color::STRING_FORMAT_FLOAT, "%i" or "%x" (or similar) for int and hex formats.
Returns
The converted string.

Referenced by Murl::Util::ValueToString().

◆ BoolToString()

String Murl::Util::BoolToString ( Bool  inputValue)

Convert a Bool value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string "true" or "false".

Referenced by Murl::Util::ValueToString().

◆ TimeToString() [1/2]

String Murl::Util::TimeToString ( const System::Time inputValue)

Convert a time value to a string.

Parameters
inputValueThe value to convert.
Returns
The converted string "h:mm:ss".

◆ TimeToString() [2/2]

String Murl::Util::TimeToString ( const System::Time inputValue,
const String separator 
)

Convert a time value to a string using a separator.

Parameters
inputValueThe value to convert.
separatorThe separator string.
Returns
The converted string "h[separator]mm[separator]ss".

Referenced by Murl::Util::ValueToString().

◆ Utf8ToWChar()

Bool Murl::Util::Utf8ToWChar ( const Char inputBytes,
UInt32 numToSkip,
WChar outputValues,
UInt32 numValues 
)

Convert an UTF8 character sequence to a wide-character.

For string operation the String class provides the GetWChars() method.

Parameters
inputBytesPointer to the UTF8 character(s).
numToSkipReturn value parameter returning the number of input bytes to skip to the next UTF8 character.
outputValuesPointer to the wide-character(s).
numValuesIn/out parameter. Must contain the number of values available in the output buffer; receives the actual number of values converted, on success. If the given number of values is smaller than the number of values needed, false is returned.
Returns
true if successful.

◆ WCharToUtf8()

Bool Murl::Util::WCharToUtf8 ( const WChar inputValues,
UInt32 numToSkip,
Char outputBytes,
UInt32 numBytes 
)

Convert a wide-character to an UTF8 character sequence.

For string operation the String class provides the SetWChars() method.

Parameters
inputValuesPointer to the wide-character(s).
numToSkipReturn value parameter returning the number of input values (not the number of bytes!) to skip to the next wide-character.
outputBytesPointer to a memory block to receive the converted bytes.
numBytesIn/out parameter. Must contain the number of bytes available in the output buffer; receives the actual number of bytes converted, on success. If the given number of bytes is smaller than the number of bytes needed, false is returned.
Returns
true if successful.

◆ Utf8ToUtf16()

Bool Murl::Util::Utf8ToUtf16 ( const Char inputBytes,
UInt32 numToSkip,
UInt16 outputValues,
UInt32 numValues 
)

Convert an UTF8 character sequence to an UTF16 character.

For string operation the String class provides the GetUTF16Chars() method.

Parameters
inputBytesPointer to the UTF8 character(s).
numToSkipReturn value parameter returning the number of input bytes to skip to the next UTF8 character.
outputValuesPointer to the UTF-16 character(s).
numValuesIn/out parameter. Must contain the number of values available in the output buffer; receives the actual number of values converted, on success. If the given number of values is smaller than the number of values needed, false is returned.
Returns
true if successful.

◆ Utf16ToUtf8()

Bool Murl::Util::Utf16ToUtf8 ( const UInt16 inputValues,
UInt32 numToSkip,
Char outputBytes,
UInt32 numBytes 
)

Convert an UTF16 character to an UTF8 character sequence.

For string operation the String class provides the SetUTF16Chars() method.

Parameters
inputValuesPointer to the UTF16 character(s).
numToSkipReturn value parameter returning the number of input values (not the number of bytes!) to skip to the next UTF16 character.
outputBytesPointer to a memory block to receive the converted bytes.
numBytesIn/out parameter. Must contain the number of bytes available in the output buffer; receives the actual number of bytes converted, on success. If the given number of bytes is smaller than the number of bytes needed, false is returned.
Returns
true if successful.

◆ Utf8ToUtf32()

Bool Murl::Util::Utf8ToUtf32 ( const Char inputBytes,
UInt32 outputValue,
UInt32 numToSkip 
)

Convert an UTF8 character sequence to an UTF32 character.

For string operation the String class provides the GetUTF32Chars() method.

Parameters
inputBytesPointer to the UTF8 character(s).
outputValueThe UTF-32 character return value.
numToSkipReturn value parameter returning the number of input bytes to skip to the next UTF8 character.
Returns
true if successful.

◆ Utf32ToUtf8()

Bool Murl::Util::Utf32ToUtf8 ( UInt32  inputValue,
Char outputBytes,
UInt32 numBytes 
)

Convert an UTF32 character to an UTF8 character sequence.

For string operation the String class provides the SetUTF32Chars() method.

Parameters
inputValueThe UTF32 character.
outputBytesPointer to a memory block to receive the converted bytes.
numBytesIn/out parameter. Must contain the number of bytes available in the output buffer; receives the actual number of bytes converted, on success. If the given number of bytes is smaller than the number of bytes needed, false is returned.
Returns
true if successful.


Copyright © 2011-2018 Spraylight GmbH.