Comportement des méthodes bang Array

Question

si aucune modification n'a été apportée Certaines versions bang de Array méthodes sont comme compact!, reject!, flatten!, uniq! retour nil:

[1,[2]].flatten! 
# => [1, 2] 
[1,2].flatten! 
# => nil 
[1,[2]].flatten 
# => [1, 2] 
[1,2].flatten 
# => [1, 2] 

[1,2,nil].compact! 
# => [1, 2] 
[1,2].compact! 
# => nil 
[1,2,nil].compact 
# => [1, 2] 
[1,2].compact 
# => [1, 2] 

S'ils l'ont fait de cette façon, il doit y avoir une raison. Des idées de ce que ça pourrait être?

Answer 1

Le bang (!) méthodes ne modifient l'objet actuel en place, mais ils ne reviennent nil s'il n'y a pas d'éléments concernés par the documentation. Ceci est utile si, pour une raison quelconque, vous devez faire quelque chose si vous avez modifié le tableau en question.

if array.flatten! 
    puts "Oh yeah... flattened that array!" 
end 

Answer 2

j'étais toujours sous l'impression que la version bang de Array méthodes sont seulement différentes de la façon dont ils modifient objet en place.

Peut-être le problème ici est que cette impression est pas vraiment un bon un: according to David A. Black, ! ne signifie pas que la méthode change de récepteur; ! signifie que cette méthode est la version "dangereuse" d'une méthode par ailleurs équivalente, qui a le même nom moins le !.

Maintenant, le danger prend de nombreuses formes (accent mines):

Parfois, vous obtenez plus d'un type de "danger" même dans une méthode Bang . Prenez le String#gsub!. Cette méthode change de récepteur:

str = "David" 
str.gsub!(/$/, " Black") 
str      # David Black 

Il diffère également de gsub (non-bang) en ce que si la chaîne ne change pas, gsub retourne une copie de la chaîne inchangé mais gsub! renvoie nil:

str.gsub(/xyz/, "blah") # David Black 
str.gsub!(/xyz/, "blah") # nil 
str      # David Black 

Le! dans gsub! vous donne un heads-up: il vous prévient de danger, et cela signifie qu'avant d'utiliser la méthode, vous devrait savoir exactement comment il se comporte . (Un simple "ri String#gsub!" devrait le faire.)

Ce "heads-up" sémantique applique également aux méthodes bang de Array.