lengthIsExact

Short summary

This assertion method checks if the current string stringToCheck is length is equal to expectedLength

Attention: All strings are handled as null terminated byte/word streams. For UTF-8 is end of the string 16#00 For UTF-16 is end of the string 16#00_00

Attention: The interface IUnicodeAssertions uses ANY_STRING, for this it's not possible to use literals/constants, because for ANY types generates the compiler __SYSTEM.AnyType and __SYSTEM.AnyType contains a pointer

Parameters

Name	Type	Comment	Kind
stringToCheck	ANY_STRING	current string to check	input
expectedLength	UDINT	expected length of stringToCheck	input
stringLengthUnit	UnicodeStringLengthUnit	string length units of measurement	input
message	AssertMessage	message if the assertion is false	input

Code

Declaration

METHOD lengthIsExact
VAR_INPUT
	(* current string to check *)
	stringToCheck	:ANY_STRING;
	(* expected length of ``stringToCheck`` *)
	expectedLength	:UDINT;
	(* string length units of measurement *)
	stringLengthUnit	:UnicodeStringLengthUnit;
	(* message if the assertion is false *)
	message			:AssertMessage;
END_VAR

Implementation

CASE stringToCheck.TypeClass OF
TYPE_CLASS.TYPE_STRING:
	THIS^.utf8Assertions.lengthIsExact(
		stringToCheck	:= stringToCheck.pValue,
		expectedLength	:= expectedLength,
		stringLengthUnit := stringLengthUnit,
		message			:= message
	);
TYPE_CLASS.TYPE_WSTRING:
	THIS^.utf16Assertions.lengthIsExact(
		stringToCheck	:= stringToCheck.pValue,
		expectedLength	:= expectedLength,
		stringLengthUnit := stringLengthUnit,
		message			:= message
	);
ELSE
	; // do nothing
END_CASE