Feature #6842

Add Optional Arguments to String#strip

Added by Tom Wardrop over 1 year ago. Updated 5 months ago.

[ruby-core:47050]
Status:Assigned
Priority:Normal
Assignee:Yukihiro Matsumoto
Category:core
Target version:next minor

Description

=begin
One of the very few things I miss from the ol' php days many years ago, was the ability to easily strip arbitrary characters from the ends of string using trim(). Typically, this is whitespace characters, and #strip currently fulfils that use case, but there are also instances where it'd be nice to be able to strip any range of characters from the ends of a string. It goes well with Array#join as often when joining strings with a delimiter, you want to make sure those strings don't already begin or end with that character.

For a full-featured #strip, I'd like to see it have the option of accepting both an Array or String. If a string is provided, each character in that string will be stripped. If an array of strings is given, each element of the array is stripped from the ends of the string - this allows for multi-character delimiters for example. Of course you could go really nuts and supports regex as well (or instead of arrays). To demonstrate the difference...

"<b>bold text</b>".strip("</b>") #=> "old text"
"<b>bold text</b>".strip(["<b>", "</b>"]) #=> "bold text"
"<em><b>bold text</b></em>".strip(["<b>", "</b>", "<em>", "</em>"]) #=> "bold text"
"<em><b>bold text</b></em>".strip(/<\/?.+?>/) #=> "bold text"

A simple real-world example; this is actually what I was wanting to do right before I came here to raise this feature request, but there's been all kinds of other use cases I've hit in the past:

['some', '/chunked', 'path/'].map{ |v| v.strip('/') }.join('/') #=> "some/chunked/path"

File#join does something similar, but when you need control over the joining character, this is the way you'd do it.

I've lost count of how many times I've wanted this in Ruby, and there's really no nice workaround. Here's an example on StackOverflow of someone asking how to achieve this stripping behaviour in ruby: http://stackoverflow.com/questions/3453262/how-to-strip-leading-and-trailing-quote-from-string-in-ruby

Obviously, you'd do the same for #lstrip and #rstrip, and all the mutable variants (#strip!, #lstrip!, #rstrip!). Looking forward to others thoughts on this one.
=end

History

#1 Updated by Thomas Sawyer over 1 year ago

=begin
The first example doesn't seem to make sense, e.g.

"bold text".strip("") #=> "old text"

I also think the interface needs to be a bit more specific about right and left stripping. Maybe use options:

strip([String,Array]) # both left and right
strip(:left=>[String,Array], :right=>[String,Array]) # selective right vs left

=end

#2 Updated by Tom Wardrop over 1 year ago

=begin
In the first example, any of the characters in the string can match. So "<", "/", "b", and ">". It stripped the "b" from the start of the string, and the "" from the end. This is how I remember trim() from php behaved, which I found quite succinct, but maybe that's because defining arrays in PHP is fairly verbose. Ruby has the shorthand array literal syntax (({%w{< / b >}})), so I don't mind if #strip was made to treat a single argument and an array of arguments the same, rather than treating a single string as an array of characters. Actually I think I'd prefer that API - certainly less confusing.

So in that case, the output of the original example would become:

"<b>bold text</b>".strip("</b>") #=> "<b>bold text"

And you'd do the following to achieve the same result as the original example:

"<b>bold text</b>".strip(%w{< / b >}) #=> "old text"

As for differentiating left and right, isn't that what #lstrip and #rstrip are for? You could easily chain them to get the desired result. E.g.

"<b>bold text</b>".lstrip("<b>").rstrip("</b>") #=> "old text"

=end

#3 Updated by Yusuke Endoh over 1 year ago

  • Status changed from Open to Assigned
  • Assignee set to Yukihiro Matsumoto

#4 Updated by Yusuke Endoh over 1 year ago

  • Target version changed from 2.0.0 to next minor

#5 Updated by Thomas Sawyer over 1 year ago

Might support regexp instead of arrays,

"bold text".strip(/[\/]/) #=> "old text"

Also note, we partially have this for #rstrip already in the form of #chomp.

#6 Updated by Charlie Somerville over 1 year ago

I don't agree with the options hash that was proposed for allowing separate strings to be stripped from the left and the right.

This:

str.strip(:left => "foo", :right => "bar")

is not as clean as something like this IMO:

str.lstrip("foo").rstrip("bar")

#7 Updated by Tom Wardrop 5 months ago

I still look forward to this feature. So much more convenient and readable than the current work-around of using regex and sub/gsub. Is there anything more that needs to be done to make this happened for Ruby 2.1 or 2.2?

#8 Updated by Fuad Saud 5 months ago

I need this a couple of weeks ago. Looks like a preety commo use case.

Also available in: Atom PDF