Sha256: 510ef884896f07a893160408ab4bd00ddd083606da25720a9d53dc1e0cc3bd5d

Contents?: true

Size: 1.11 KB

Versions: 16

Compression:

Stored size: 1.11 KB

Contents

require 'scanf'

Puppet::Parser::Functions::newfunction(
  :scanf,
  :type => :rvalue,
  :arity => 2,
  :doc => <<-DOC
Scans a string and returns an array of one or more converted values based on the given format string.
See the documentation of Ruby's String#scanf method for details about the supported formats (which
are similar but not identical to the formats used in Puppet's `sprintf` function.)

This function takes two mandatory arguments: the first is the string to convert, and the second is
the format string. The result of the scan is an array, with each successfully scanned and transformed value.
The scanning stops if a scan is unsuccessful, and the scanned result up to that point is returned. If there
was no successful scan, the result is an empty array.

   "42".scanf("%i")

You can also optionally pass a lambda to scanf, to do additional validation or processing.

    "42".scanf("%i") |$x| {
      unless $x[0] =~ Integer {
        fail "Expected a well formed integer value, got '$x[0]'"
      }
      $x[0]
    }
- since 4.0.0
DOC
) do |args|
  data = args[0]
  format = args[1]
  result = data.scanf(format)
end

Version data entries

16 entries across 16 versions & 1 rubygems

Version Path
puppet-4.7.1 lib/puppet/parser/functions/scanf.rb
puppet-4.7.1-x86-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.7.1-x64-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.7.1-universal-darwin lib/puppet/parser/functions/scanf.rb
puppet-4.7.0 lib/puppet/parser/functions/scanf.rb
puppet-4.7.0-x86-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.7.0-x64-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.7.0-universal-darwin lib/puppet/parser/functions/scanf.rb
puppet-4.6.2 lib/puppet/parser/functions/scanf.rb
puppet-4.6.2-x86-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.6.2-x64-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.6.2-universal-darwin lib/puppet/parser/functions/scanf.rb
puppet-4.6.1-x86-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.6.1 lib/puppet/parser/functions/scanf.rb
puppet-4.6.1-x64-mingw32 lib/puppet/parser/functions/scanf.rb
puppet-4.6.1-universal-darwin lib/puppet/parser/functions/scanf.rb