parse[int|real|string]array

Prototype: parseintarray(array, input, comment, split, maxentries, maxbytes)
Prototype: parserealarray(array, input, comment, split, maxentries, maxbytes)
Prototype: parsestringarray(array, input, comment, split, maxentries, maxbytes)

Return type: int

Description: Parses up to maxentries values from the first maxbytes bytes in string input and populates array. Returns the dimension.

These functions mirror the exact behavior of their [read[int|real|string]array()][read[int|real|string]array] counterparts, but read data from a variable instead of a file. By making data readable from a variable, data driven policies can be kept inline.

Arguments:

• array : Array identifier to populate, in the range [a-zA-Z0-9_$(){}\[\].:]+
• input : A string to parse for input data, in the range "?(/.*)
• comment : Unanchored regex matching comments, in the range .*
• split : Unanchored regex to split data, in the range .*
• maxentries : Maximum number of entries to read, in the range 0,99999999999
• maxbytes : Maximum bytes to read, in the range 0,99999999999

Example:

    bundle agent test(f) 
    {
      vars:
         # Define data inline for convenience
        "table"   string => 
          "1:2
          3:4
          5:6";

       "dim" int => parseintarray(
                                "items",
                        "$(table)",
                        "\s*#[^\n]*",
                        ":",
                        "1000",
                        "200000"
                        );

       "keys" slist => getindices("items");

      reports:
          "$(keys)";
    }

History: Was introduced in version 3.1.5a1, Nova 2.1.0 (2011)