pure functionsubstring

Return a substring defined by start and end index

Extends from Modelica.Icons.Function (Icon for functions).

Information

Syntax

string2 = Strings.substring(string, startIndex, endIndex);

Description

This function returns the substring from position startIndex up to and including position endIndex of "string" . The substring computation has the following properties:

  • If the startIndex is non-positive, it is set to 1 and a warning is raised.
  • If the startIndex exceeds the string length, the returned substring is empty.
  • If the endIndex is negative, it is set to the startIndex and a warning is raised. The returned substring is the single character at position startIndex of string.
  • If the endIndex is non-negative and less than the startIndex, the returned substring is empty.
  • If the endIndex exceeds the string length, it is set to the string length.
  • It is only intended for ASCII encoded strings. For UTF-8 encoded strings the index is seen as bytes, and some index values may break the string inside glyphs or even inside code points.

Example

string1 := "This is line 111";
string2 := Strings.substring(string1,9,12); // string2 = "line"
string3 := Strings.substring(string1,9,0); // string3 = ""

Inputs

TypeNameDefaultDescription
StringstringString from which a substring is inquired
IntegerstartIndexCharacter position of substring begin (index=1 is first character in string)
IntegerendIndexCharacter position of substring end

Outputs

TypeNameDefaultDescription
StringresultString containing substring string[startIndex:endIndex]