<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/css" href="/stylesheets/rss.css"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/">
  <channel>
    <title>Say what???: Ruby Method of the Day - Array.reject!</title>
    <link>http://drotner.org/articles/2007/11/21/ruby-method-of-the-day-array-inplace-reject</link>
    <language>en-us</language>
    <ttl>40</ttl>
    <description>by Kelly McCauley</description>
    <item>
      <title>Ruby Method of the Day - Array.reject!</title>
      <description>&lt;h3&gt;Signature&lt;/h3&gt;




&lt;div class="CodeRay"&gt;
  &lt;div class="code"&gt;&lt;pre&gt;array.reject! {|element| block}  &lt;span class="c"&gt;#=&amp;gt; array or nil&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;
&lt;/div&gt;



&lt;p&gt;&lt;code&gt;array.reject {|element| block}&lt;/code&gt; does the exact same thing as
&lt;a href="http://drotner.org/articles/2007/11/14/ruby-method-of-the-day-array-delete-if"&gt;&lt;code&gt;Array.delete_if&lt;/code&gt;&lt;/a&gt;
except that it returns &lt;code&gt;nil&lt;/code&gt; if no changes were made to &lt;code&gt;array&lt;/code&gt;.&lt;/p&gt;

	&lt;h3&gt;Examples&lt;/h3&gt;




&lt;table class="CodeRay"&gt;&lt;tr&gt;
  &lt;td class="line_numbers" title="click to toggle" onclick="with (this.firstChild.style) { display = (display == '') ? 'none' : '' }"&gt;&lt;pre&gt;1&lt;tt&gt;
&lt;/tt&gt;2&lt;tt&gt;
&lt;/tt&gt;3&lt;tt&gt;
&lt;/tt&gt;4&lt;tt&gt;
&lt;/tt&gt;5&lt;tt&gt;
&lt;/tt&gt;6&lt;tt&gt;
&lt;/tt&gt;7&lt;tt&gt;
&lt;/tt&gt;8&lt;tt&gt;
&lt;/tt&gt;9&lt;tt&gt;
&lt;/tt&gt;&lt;strong&gt;10&lt;/strong&gt;&lt;tt&gt;
&lt;/tt&gt;11&lt;tt&gt;
&lt;/tt&gt;12&lt;tt&gt;
&lt;/tt&gt;13&lt;tt&gt;
&lt;/tt&gt;14&lt;tt&gt;
&lt;/tt&gt;15&lt;tt&gt;
&lt;/tt&gt;16&lt;tt&gt;
&lt;/tt&gt;17&lt;tt&gt;
&lt;/tt&gt;18&lt;tt&gt;
&lt;/tt&gt;&lt;/pre&gt;&lt;/td&gt;
  &lt;td class="code"&gt;&lt;pre ondblclick="with (this.style) { overflow = (overflow == 'auto' || overflow == '') ? 'visible' : 'auto' }"&gt;a = [&lt;span class="i"&gt;1&lt;/span&gt;, &lt;span class="i"&gt;2&lt;/span&gt;, &lt;span class="i"&gt;3&lt;/span&gt;, &lt;span class="i"&gt;4&lt;/span&gt;, &lt;span class="i"&gt;5&lt;/span&gt;, &lt;span class="i"&gt;6&lt;/span&gt;, &lt;span class="i"&gt;7&lt;/span&gt;, &lt;span class="i"&gt;8&lt;/span&gt;, &lt;span class="i"&gt;9&lt;/span&gt;, &lt;span class="i"&gt;10&lt;/span&gt;]&lt;tt&gt;
&lt;/tt&gt;&lt;tt&gt;
&lt;/tt&gt;b = a.clone                 &lt;span class="c"&gt;#=&amp;gt; [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b.reject! {&lt;span class="pc"&gt;true&lt;/span&gt;}            &lt;span class="c"&gt;#=&amp;gt; []&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b                           &lt;span class="c"&gt;#=&amp;gt; []&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;&lt;tt&gt;
&lt;/tt&gt;b = a.clone                 &lt;span class="c"&gt;#=&amp;gt; [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b.reject! {&lt;span class="pc"&gt;false&lt;/span&gt;}           &lt;span class="c"&gt;#=&amp;gt; nil&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b                           &lt;span class="c"&gt;#=&amp;gt; [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;&lt;tt&gt;
&lt;/tt&gt;b = a.clone                 &lt;span class="c"&gt;#=&amp;gt; [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b.reject! {|n| n == &lt;span class="i"&gt;3&lt;/span&gt;}      &lt;span class="c"&gt;#=&amp;gt; [1, 2, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b                           &lt;span class="c"&gt;#=&amp;gt; [1, 2, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;&lt;tt&gt;
&lt;/tt&gt;b = a.clone                 &lt;span class="c"&gt;#=&amp;gt; [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b.reject! {|n| n % &lt;span class="i"&gt;2&lt;/span&gt; == &lt;span class="i"&gt;0&lt;/span&gt;}  &lt;span class="c"&gt;#=&amp;gt; [1, 3, 5, 7, 9]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;b                           &lt;span class="c"&gt;#=&amp;gt; [1, 3, 5, 7, 9]&lt;/span&gt;&lt;tt&gt;
&lt;/tt&gt;&lt;tt&gt;
&lt;/tt&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;/tr&gt;&lt;/table&gt;



	&lt;h3&gt;Documentation Reference&lt;/h3&gt;


	&lt;p&gt;Ruby version 1.8.6&lt;/p&gt;


	&lt;p&gt;&lt;a href="http://www.ruby-doc.org"&gt;www.ruby-doc.org&lt;/a&gt; : &lt;a href="http://www.ruby-doc.org/core/classes/Array.html#M002220"&gt;Array.reject!&lt;/a&gt;&lt;/p&gt;


</description>
      <pubDate>Wed, 21 Nov 2007 00:01:00 -0600</pubDate>
      <guid isPermaLink="false">urn:uuid:a738fd50-06a5-4fdc-9edb-ef25d2895f47</guid>
      <author>Kelly McCauley</author>
      <link>http://drotner.org/articles/2007/11/21/ruby-method-of-the-day-array-inplace-reject</link>
      <category>Ruby Method of the Day</category>
      <category>Programming</category>
      <category>ruby</category>
      <category>rmotd</category>
      <trackback:ping>http://drotner.org/articles/trackback/75</trackback:ping>
    </item>
  </channel>
</rss>
