Sha256: 3672870c02086f21c5d4bda8328b2207212243c05a7cc60c6653590ad986e4c2

Contents?: true

Size: 876 Bytes

Versions: 28

Compression:

Stored size: 876 Bytes

Contents

# frozen_string_literal: true

module Puppet::Parser::Functions
  newfunction(
    :split, :type => :rvalue,
            :arity => 2,

            :doc => "\
Split a string variable into an array using the specified split regexp.

*Example:*

    $string     = 'v1.v2:v3.v4'
    $array_var1 = split($string, ':')
    $array_var2 = split($string, '[.]')
    $array_var3 = split($string, Regexp['[.:]'])

`$array_var1` now holds the result `['v1.v2', 'v3.v4']`,
while `$array_var2` holds `['v1', 'v2:v3', 'v4']`, and
`$array_var3` holds `['v1', 'v2', 'v3', 'v4']`.

Note that in the second example, we split on a literal string that contains
a regexp meta-character (.), which must be escaped.  A simple
way to do that for a single character is to enclose it in square
brackets; a backslash will also escape a single character."
  ) do |_args|
    Error.is4x('split')
  end
end

Version data entries

28 entries across 28 versions & 1 rubygems

Version Path
puppet-8.10.0 lib/puppet/parser/functions/split.rb
puppet-8.10.0-x86-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.10.0-x64-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.10.0-universal-darwin lib/puppet/parser/functions/split.rb
puppet-8.9.0 lib/puppet/parser/functions/split.rb
puppet-8.9.0-x86-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.9.0-x64-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.9.0-universal-darwin lib/puppet/parser/functions/split.rb
puppet-8.8.1 lib/puppet/parser/functions/split.rb
puppet-8.8.1-x86-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.8.1-x64-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.8.1-universal-darwin lib/puppet/parser/functions/split.rb
puppet-8.7.0 lib/puppet/parser/functions/split.rb
puppet-8.7.0-x86-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.7.0-x64-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.7.0-universal-darwin lib/puppet/parser/functions/split.rb
puppet-8.6.0 lib/puppet/parser/functions/split.rb
puppet-8.6.0-x86-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.6.0-x64-mingw32 lib/puppet/parser/functions/split.rb
puppet-8.6.0-universal-darwin lib/puppet/parser/functions/split.rb