Prototype: readintarray(array, filename, comment, split, maxentries, maxbytes)

Return type: int

Description: Populates array with up to maxentries values, parsed from the first maxbytes bytes in file filename.

Reads a two dimensional array from a file. One dimension is separated by the regex split, the other by the lines in the file. The first field of the lines names the first array argument.

The comment field is a multiline regular expression and will strip out unwanted patterns from the file being read, leaving unstripped characters to be split into fields. Using the empty string ("") indicates no comments.

Returns the number of keys in the array, i.e., the number of lines matched.

Arguments:

Example:

Prepare:

[%CFEngine_include_snippet(readintarray.cf, #+begin_src prep, .*end_src)%]

Run:

[%CFEngine_include_snippet(readintarray.cf, #+begin_src cfengine3, .*end_src)%]

Output:

[%CFEngine_include_snippet(readintarray.cf, #+begin_src\s+example_output\s, .end_src)%]

See Also: [readstringarray()][readstringarray], [readrealarray()][readrealarray], [parseintarray()][parseintarray], [parserealarray()][parserealarray], [parsestringarray()][parsestringarray]