GOLF(2gg)

NAME
split-string - (strings)

PURPOSE
Split a string into pieces based on a delimiter.

SYNTAX

        split-string  <string> with <delimiter> to <result> [ count <count> ]

        split-string delete <result>

DESCRIPTION
split-string will find all instances of string <delimiter> in <string> and then split it into pieces delimited by string <delimiter>. The <result> can be used with read-split to obtain the pieces and with split-string to delete it (use "delete" clause with <result> to delete it).

If "count" clause is used, then the number of pieces is in <count>.

All pieces produced will be trimmed both on left and right. If a piece is double quoted, then double quotes are removed. For instance save this code in "ps.golf" in a separate directory:

        %% /parse public
            set-string clist = "a , b, \"c , d\" , e"
            split-string clist with "," to res count tot
            start-loop repeat tot use i
                read-split i from res to item status st
                if-true st not-equal GG_OKAY
                    break-loop
                end-if
                // Output each item
                print-format " [%s]", item
            end-loop
        %%

Create the application, build and run it:

        sudo mgrg -i -u $(whoami) ps
        gg -q
        gg -r --req="/parse" --exec --silent-header

The output would be:

         [a] [b] [c , d] [e]

split-string is useful for parsing CSV (Comma Separated Values) or any other kind of separated values, where separator can be any string of any length, for example if you're parsing an encoded URL-string, then "&amp;" may be a separator, as in the example below.

EXAMPLES
The following will parse a string containing name/value pairs (such as "name=value") separated by string "&amp;":

        %% /parse-url public
            // Data to parse - data/value pairs delimited by "&amp;" string, and data and value delimited by equal sign:
            set-string url ="x=23&amp;y=good&amp;z=hello_world"

            // Split string first into pieces based on "amp;"
            split-string url with "&amp;" to url_var count tot

            // For each of name=value pairs, split it with equal sign
            start-loop repeat tot use i
                // Get a url pair (each separated with "&amp;")
                read-split i from url_var to item
                // Then split that with "="
                split-string item with "=" to item_var
                // Get name and value
                read-split 1 from item_var to name
                read-split 2 from item_var to val
                print-format "Variable %s has value %s\n", name, val
            end-loop
        %%

The result is:

        Variable x has value 23
        Variable y has value good
        Variable z has value hello_world

SEE ALSO
 Strings

concatenate-strings copy-string count-substring delete-string lower-string new-string read-split replace-string set-string split-string string-length trim-string upper-string write-string See all documentation