diff options
author | Jeff McCune <jeff@puppetlabs.com> | 2011-08-18 13:45:28 -0700 |
---|---|---|
committer | Jeff McCune <jeff@puppetlabs.com> | 2011-08-18 13:45:28 -0700 |
commit | bdba42dbb6328ccc5bb13f0777240fdb85e538ca (patch) | |
tree | de11ef579d7ffec6c7161945da5e84b75287d629 /lib/puppet/parser/functions/validate_re.rb | |
parent | ad5316f561475157e425a7fddf1365e8e89b2b9d (diff) | |
parent | 8e770b04234aacfc09c7b8ad45ffa304cb83f723 (diff) |
Merge pull request #16 from nfagerlund/docs/v2.0.0/XXXX_function_doc_updates
Docs/v2.0.0/xxxx function doc updates
Diffstat (limited to 'lib/puppet/parser/functions/validate_re.rb')
-rw-r--r-- | lib/puppet/parser/functions/validate_re.rb | 18 |
1 files changed, 8 insertions, 10 deletions
diff --git a/lib/puppet/parser/functions/validate_re.rb b/lib/puppet/parser/functions/validate_re.rb index 583f26a..8033ca3 100644 --- a/lib/puppet/parser/functions/validate_re.rb +++ b/lib/puppet/parser/functions/validate_re.rb @@ -1,24 +1,22 @@ module Puppet::Parser::Functions newfunction(:validate_re, :doc => <<-'ENDHEREDOC') do |args| - Perform simple validation of a string against a regular expression. The second - argument of the function should be a string regular expression (without the //'s) - or an array of regular expressions. If none of the regular expressions in the array - match the string passed in, then an exception will be raised. + Perform simple validation of a string against one or more regular + expressions. The first argument of this function should be a string to + test, and the second argument should be a stringified regular expression + (without the // delimiters) or an array of regular expressions. If none + of the regular expressions match the string passed in, compilation will + abort with a parse error. - Example: - - These strings validate against the regular expressions + The following strings will validate against the regular expressions: validate_re('one', '^one$') validate_re('one', [ '^one', '^two' ]) - These strings do NOT validate + The following strings will fail to validate, causing compilation to abort: validate_re('one', [ '^two', '^three' ]) - Jeff McCune <jeff@puppetlabs.com> - ENDHEREDOC if args.length != 2 then raise Puppet::ParseError, ("validate_re(): wrong number of arguments (#{args.length}; must be 2)") |