ReadLines

file,-folder-and-read-functions ReadLines

syntax

• ReadLines(source, domainunit, startposition)

definition

ReadLines(source, domainunit, startposition) results in a data-item, with the concatenation of the values of the rows of the source argument.

The second argument domainunit configures the domain-unit of the resulting data item, for parameters this argument is void.

The third argument startposition configures the read position in the source.

The number of lines read is defined by the number of elements of the domain unit. In the resulting data item the delimiter between each value is the string representation of the tab character (\t).

The ReadLines function also generates a uint32 parameter subitem, called ReadPos. This parameter indicates the position of the next value after the value being read by the ReadLines function, see the example.

applies to

• parameter source with string value-type
• unit domainunit with value type from group CanBeDomainUnit
• parameter startposition with uint32 value type

example

container ReadLines
{
   parameter<string> file: StorageName = "%projDir%/data/text.txt", StorageType = "str";

   unit<uint32> BDomain: nrofrows = 6;

   parameter<string> Header             := ReadLines(file, void, 0); // result = 6 9.02 Test True
   attribute<string> BodyRows (BDomain) := ReadLines(file, BDomain, Header/ReadPos);
};

text.txt

BodyRows, BDomain, nr of rows = 6

see also

• readvalue
• readelems
• readarray