Sha256: 7cb4e41a45db28b4845d42ca3158feae456aff86d7b7c802e7b6539b7a67fcd5
Contents?: true
Size: 1.26 KB
Versions: 611
Compression:
Stored size: 1.26 KB
Contents
# 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
#
Puppet::Functions.create_function(:scanf) do
require 'scanf'
dispatch :scanf do
param 'String', :data
param 'String', :format
optional_block_param
end
def scanf(data, format)
result = data.scanf(format)
if block_given?
result = yield(result)
end
result
end
end
Version data entries
611 entries across 611 versions & 3 rubygems