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, ColorStringFormat &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, ColorStringFormat &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, ColorStringFormat 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, ColorStringFormat 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. More...

String	Murl::Util::ValueToString (SInt64 inputValue)
	ValueToString overload for SInt64ToString() method. More...

String	Murl::Util::ValueToString (UInt32 inputValue)
	ValueToString overload for UInt32ToString() method. More...

String	Murl::Util::ValueToString (SInt32 inputValue)
	ValueToString overload for SInt32ToString() method. More...

String	Murl::Util::ValueToString (Double inputValue)
	ValueToString overload for DoubleToString() method. More...

String	Murl::Util::ValueToString (const Color &inputValue)
	ValueToString overload for ColorToString() method. More...

String	Murl::Util::ValueToString (Bool inputValue)
	ValueToString overload for BoolToString() method. More...

String	Murl::Util::ValueToString (const System::Time &inputValue)
	ValueToString overload for TimeToString() method. More...

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

inputString The string to convert.

value The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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,
		ColorStringFormat &	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

inputString	The string to convert.
value	The color return value.
format	This 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

inputString	The string to convert.
value	The color return value.
hasType	This 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

inputString	The string to convert.
value	The 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,
		ColorStringFormat &	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

inputString	The string to convert.
value	The color component return value.
format	This 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

inputString	The string to convert.
value	The color component return value.
hasType	This 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The 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

inputString	The string to convert.
value	The angle return value.
hasUnit	This 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputString	The string to convert.
delimiter	The delimiter character.
values	Pointer to the return values array.
numValues	The 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

inputValue The value to convert.

Returns: The converted string.

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

◆ SInt64ToString() [1/2]

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

Convert a SInt64 value to a string.

Parameters

inputValue The value to convert.

Returns: The converted string.

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

◆ UInt32ToString() [1/2]

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

Convert a UInt32 value to a string.

Parameters

inputValue The value to convert.

Returns: The converted string.

Referenced by Murl::Logic::GraphInstanceObjects< InstanceObjectType >::Init(), and Murl::Util::ValueToString().

◆ SInt32ToString() [1/2]

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

Convert a SInt32 value to a string.

Parameters

inputValue The value to convert.

Returns: The converted string.

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

◆ DoubleToString() [1/2]

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

Convert a Double value to a string.

Parameters

inputValue The value to convert.

Returns: The converted string.

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

◆ ColorToString() [1/4]

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

Convert a Color object to a string in float representation.

Parameters

inputValue The color to convert.

Returns: The converted string.

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

◆ ColorToString() [2/4]

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

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

Parameters

inputValue	The color to convert.
colorStringFormat	The 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

inputValue	The value to convert.
format	The format string should contain "%llu".

Returns: The converted string.

◆ SInt64ToString() [2/2]

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

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

Parameters

inputValue	The value to convert.
format	The format string should contain "%lld".

Returns: The converted string.

◆ UInt32ToString() [2/2]

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

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

Parameters

inputValue	The value to convert.
format	The format string should contain "%u".

Returns: The converted string.

◆ SInt32ToString() [2/2]

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

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

Parameters

inputValue	The value to convert.
format	The format string should contain "%d".

Returns: The converted string.

◆ DoubleToString() [2/2]

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

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

Parameters

inputValue	The value to convert.
format	The format string should contain "%f" or "%g".

Returns: The converted string.

◆ ColorToString() [3/4]

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

Convert a Color object to a string in float representation.

Parameters

inputValue	The color to convert.
format	The format string should contain "%f" or "%g".

Returns: The converted string.

◆ ColorToString() [4/4]

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

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

Parameters

inputValue	The color to convert.
colorStringFormat	The color string format
format	The 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.

◆ BoolToString()

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

Convert a Bool value to a string.

Parameters

inputValue The 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

inputValue The value to convert.

Returns: The converted string "h:mm:ss".

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

◆ 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

inputValue	The value to convert.
separator	The separator string.

Returns: The converted string "h[separator]mm[separator]ss".

◆ 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

inputBytes	Pointer to the UTF8 character(s).
numToSkip	Return value parameter returning the number of input bytes to skip to the next UTF8 character.
outputValues	Pointer to the wide-character(s).
numValues	In/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

inputValues	Pointer to the wide-character(s).
numToSkip	Return value parameter returning the number of input values (not the number of bytes!) to skip to the next wide-character.
outputBytes	Pointer to a memory block to receive the converted bytes.
numBytes	In/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

inputBytes	Pointer to the UTF8 character(s).
numToSkip	Return value parameter returning the number of input bytes to skip to the next UTF8 character.
outputValues	Pointer to the UTF-16 character(s).
numValues	In/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

inputValues	Pointer to the UTF16 character(s).
numToSkip	Return value parameter returning the number of input values (not the number of bytes!) to skip to the next UTF16 character.
outputBytes	Pointer to a memory block to receive the converted bytes.
numBytes	In/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

inputBytes	Pointer to the UTF8 character(s).
outputValue	The UTF-32 character return value.
numToSkip	Return 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

inputValue	The UTF32 character.
outputBytes	Pointer to a memory block to receive the converted bytes.
numBytes	In/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.

◆ ValueToString() [1/8]

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

inline

ValueToString overload for UInt64ToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::UInt64ToString().

Referenced by Murl::Math::MinMax< DataType, LimitsType >::ToString().

◆ ValueToString() [2/8]

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

inline

ValueToString overload for SInt64ToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::SInt64ToString().

◆ ValueToString() [3/8]

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

inline

ValueToString overload for UInt32ToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::UInt32ToString().

◆ ValueToString() [4/8]

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

inline

ValueToString overload for SInt32ToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::SInt32ToString().

◆ ValueToString() [5/8]

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

inline

ValueToString overload for DoubleToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::DoubleToString().

◆ ValueToString() [6/8]

String Murl::Util::ValueToString ( const Color & inputValue )

inline

ValueToString overload for ColorToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::ColorToString().

◆ ValueToString() [7/8]

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

inline

ValueToString overload for BoolToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::BoolToString().

◆ ValueToString() [8/8]

String Murl::Util::ValueToString ( const System::Time & inputValue )

inline

ValueToString overload for TimeToString() method.

Parameters

inputValue The value to convert.

Returns: The converted string.

References Murl::Util::TimeToString().