#  Copyright 2021 Northern.tech AS
#  This file is part of CFEngine 3 - written and maintained by Northern.tech AS.
#  This program is free software; you can redistribute it and/or modify it
#  under the terms of the GNU General Public License as published by the
#  Free Software Foundation; version 3.
#  This program is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
# To the extent this program is licensed as part of the Enterprise
# versions of Cfengine, the applicable Commercial Open Source License
# (COSL) may apply to this file if you as a licensee so wish it. See
# included file COSL.txt.
#+begin_src cfengine3
bundle agent main
{
  vars:
    # global regex replace A with B
    "AB" string => regex_replace("This has AAA rating", "A", "B", "g");

    # global regex replace [Aa] with B (case insensitive)
    "AaB" string => regex_replace("This has AAA rating", "A", "B", "gi");

    # global replace every three characters with [cap=thecharacters] using $1
    "cap123"
      string => regex_replace("abcdefghijklmn", "(...)", "[cap=$1]", "g");

    # multiple captures using \1 \2 (just like $1 $2 but can only go up to \9)
    "path_breakdown"
      string => regex_replace(
        "/a/b/c/example.txt",
        "(.+)/(.+)",
        "dirname = \1 file basename = \2",
        ""
      );

  reports:
    # in order, the above...
    "AB replacement = '$(AB)'";
    "AaB replacement = '$(AaB)'";
    "cap123 replacement = '$(cap123)'";
    "path_breakdown replacement = '$(path_breakdown)'";
}

#+end_src
###############################################################################
#+begin_src example_output
#@ ```
#@ R: AB replacement = 'This has BBB rating'
#@ R: AaB replacement = 'This hBs BBB rBting'
#@ R: cap123 replacement = '[cap=abc][cap=def][cap=ghi][cap=jkl]mn'
#@ R: path_breakdown replacement = 'dirname = /a/b/c file basename = example.txt'
#@ ```
#+end_src
