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 windows-1252 is end of the string 16#00 For UTF-16 is end of the string 16#00_00

Attention: Method uses ANY_STRING and for this it's not possible to use literals/constants, because for ANY types the compiler generates__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