summaryrefslogtreecommitdiffstats
path: root/lib/puppet/parser
diff options
context:
space:
mode:
authorLuke Kanies <luke@madstop.com>2009-04-07 15:11:56 -0500
committerLuke Kanies <luke@madstop.com>2009-04-07 15:11:56 -0500
commit7bb8c35f6c70cf32feba9a3ce224155b9d446289 (patch)
treeca2e50dec13fcaae50b2eb68993230d046c0620c /lib/puppet/parser
parentd2c417ef48dbb2074c1c58ec2c86ba2d52ecc895 (diff)
parent0863a7928ff6c15dcd8ace7119a3fa64bbcec6b3 (diff)
downloadpuppet-7bb8c35f6c70cf32feba9a3ce224155b9d446289.tar.gz
puppet-7bb8c35f6c70cf32feba9a3ce224155b9d446289.tar.xz
puppet-7bb8c35f6c70cf32feba9a3ce224155b9d446289.zip
Merge branch '0.24.x'
Diffstat (limited to 'lib/puppet/parser')
-rw-r--r--lib/puppet/parser/functions/regsubst.rb70
-rw-r--r--lib/puppet/parser/functions/sprintf.rb9
2 files changed, 25 insertions, 54 deletions
diff --git a/lib/puppet/parser/functions/regsubst.rb b/lib/puppet/parser/functions/regsubst.rb
index 067d75c51..c79983351 100644
--- a/lib/puppet/parser/functions/regsubst.rb
+++ b/lib/puppet/parser/functions/regsubst.rb
@@ -1,63 +1,39 @@
module Puppet::Parser::Functions
newfunction(:regsubst, :type => :rvalue,
- :doc => "\
- Perform regexp replacement on a string.
+ :doc => "
+ Perform regexp replacement on a string. Parameters (in order):
- Parameters (in order):
+:str: The string to operate on.
- :str:
- The string to operate on.
+:regexp: The regular expression matching the string. If you want it anchored at the start and or end of the string, you must do that with ^ and $ yourself.
- :regexp:
- The regular expression matching the string. If you want it
- anchored at the start and/or end of the string, you must do
- that with ^ and $ yourself.
+:replacement: Replacement string. Can contain back references to what was matched using 0, 1, and so on.
- :replacement:
- Replacement string. Can contain back references to what was
- matched using \\0, \\1, and so on.
+:flags: Optional. String of single letter flags for how the regexp is interpreted:
- :flags:
- Optional. String of single letter flags for how the regexp
- is interpreted:
+ - **E** Extended regexps
+ - **I** Ignore case in regexps
+ - **M** Multiline regexps
+ - **G** Global replacement; all occurrences of the regexp in the string will be replaced. Without this, only the first occurrence will be replaced.
- - **E**
- Extended regexps
- - **I**
- Ignore case in regexps
- - **M**
- Multiline regexps
- - **G**
- Global replacement; all occurances of the regexp in
- the string will be replaced. Without this, only the
- first occurance will be replaced.
+:lang: Optional. How to handle multibyte characters. A single-character string with the following values:
+
+ - **N** None
+ - **E** EUC
+ - **S** SJIS
+ - **U** UTF-8
- :lang:
- Optional. How to handle multibyte characters. A
- single-character string with the following values:
+**Examples**
- - **N**
- None
- - **E**
- EUC
- - **S**
- SJIS
- - **U**
- UTF-8
+Get the third octet from the node's IP address::
- **Examples**
+ $i3 = regsubst($ipaddress,'^([0-9]+)[.]([0-9]+)[.]([0-9]+)[.]([0-9]+)$','\\3')
- Get the third octet from the node's IP address: ::
+Put angle brackets around each octet in the node's IP address::
- $i3 = regsubst($ipaddress,
- '^([0-9]+)[.]([0-9]+)[.]([0-9]+)[.]([0-9]+)$',
- '\\\\3')
-
- Put angle brackets around each octet in the node's IP address: ::
-
- $x = regsubst($ipaddress, '([0-9]+)', '<\\\\1>', 'G')
- ") \
- do |args|
+ $x = regsubst($ipaddress, '([0-9]+)', '<\\1>', 'G')
+") \
+ do |args|
flag_mapping = {
"E" => Regexp::EXTENDED,
"I" => Regexp::IGNORECASE,
diff --git a/lib/puppet/parser/functions/sprintf.rb b/lib/puppet/parser/functions/sprintf.rb
index 79744104d..f6daeff49 100644
--- a/lib/puppet/parser/functions/sprintf.rb
+++ b/lib/puppet/parser/functions/sprintf.rb
@@ -1,13 +1,8 @@
module Puppet::Parser::Functions
newfunction(:sprintf, :type => :rvalue,
- :doc => "\
- Perform printf-style formatting of text.
+ :doc => "Perform printf-style formatting of text.
- The first parameter is format string describing how the rest of the
- parameters should be formatted. See the documentation for the
- ``Kernel::sprintf()`` function in Ruby for all the details.
- ") \
- do |args|
+ The first parameter is format string describing how the rest of the parameters should be formatted. See the documentation for the ``Kernel::sprintf()`` function in Ruby for all the details.") do |args|
if args.length < 1
raise Puppet::ParseError, 'sprintf() needs at least one argument'
end