--- !ruby/object:RI::MethodDescription
aliases: []
block_params:
comment:
- !ruby/struct:SM::Flow::P
body: Returns a copy of str with all occurrences of pattern replaced with either replacement or the value of the block. The pattern will typically be a Regexp; if it is a String then no regular expression metacharacters will be interpreted (that is /\d/ will match a digit, but '\d' will match a backslash followed by a 'd').
- !ruby/struct:SM::Flow::P
body: If a string is used as the replacement, special variables from the match (such as $& and $1) cannot be substituted into it, as substitution into the string occurs before the pattern match starts. However, the sequences \1, \2, and so on may be used to interpolate successive groups in the match.
- !ruby/struct:SM::Flow::P
body: In the block form, the current match string is passed in as a parameter, and variables such as $1, $2, $`, $&, and $' will be set appropriately. The value returned by the block will be substituted for the match on each call.
- !ruby/struct:SM::Flow::P
body: The result inherits any tainting in the original string or any supplied replacement string.
- !ruby/struct:SM::Flow::VERB
body: " "hello".gsub(/[aeiou]/, '*') #=> "h*ll*"\n "hello".gsub(/([aeiou])/, '<\\1>') #=> "h<e>ll<o>"\n "hello".gsub(/./) {|s| s[0].to_s + ' '} #=> "104 101 108 108 111 "\n"
full_name: String#gsub
is_singleton: false
name: gsub
params: |
str.gsub(pattern, replacement) => new_str
str.gsub(pattern) {|match| block } => new_str
visibility: public