supplement 2.22 → 2.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfe383724f7aaa07dc2be7524d3ab6e11908ede513e133251b01989572343e59
-  data.tar.gz: 64121897e3f8388666664d0911b74ae18a4b8c378b6c38737edc0414e5262629
+  metadata.gz: 196a040bf5dba1ea9778b2a9c2335698e6d43214832a3106bb6efbb616d718ac
+  data.tar.gz: 41af129cdd0a520ee715b9663395c63e39754a8be3a494bb62d8e7a4d30cf8c0
 SHA512:
-  metadata.gz: '0549d67c614aad498ad70160933d2122290b864013ff73b564a57b8f80a8cceaa86c9c57dd222641be738dbf6232e0dccb78b9b3610888055fdf5706bf678f8a'
-  data.tar.gz: eac0f15c6799f7e096abea90146351d33c905e85d78fe0e293a83a1ce611f96b10ba5bf6bc84c3f8271ac1822a8b702794066abe9c8210a5b3dddb0a88c94849
+  metadata.gz: fbf458038e5b477e340faf16ecbfa98058be9d2b3014253ce448666af627573c6b51eb9d4949fb0cf04af48b7bc42c15b304d39fa4ce3c2ceb0c0ac727a952b1
+  data.tar.gz: decd0d8dfa69fae98b8f03c4e19b06f9f28bf341d24bf38b83837ff8f955ec81a0b01904bd0c7bdee4077d7ec27c6c0f168997f861251f2c1aba0aca794aba50

data/README

@@ -1,4 +1,4 @@
-= supplement 2.22  --  Useful Ruby enhancements
+= supplement 2.24  --  Useful Ruby enhancements
 
 
 Some simple Ruby extensions.
@@ -55,6 +55,7 @@ Now here it is where I can just point to.
   * String#start_with?
   * String#end_with?
   * Array#notempty?
+  * Array#first=/last=
   * Hash#notempty?
   * Struct.[]
   * Integer.roman

data/lib/supplement.c

@@ -814,6 +814,56 @@ rb_ary_notempty_p( VALUE ary)
     return RARRAY_LEN( ary) == 0 ? Qnil : ary;
 }
 
+/*
+ *  call-seq:
+ *     first = obj  -> obj
+ *
+ *  Replace the first element. Equivalent to <code>ary[0]=</code>.
+ *
+ *    a = [ -1, 39, 56]
+ *    a.first = 42
+ *    a                            #=> [42, 39, 56]
+ *    a.unshift 266
+ *    a.first /= 14
+ *    a                            #=> [19, 42, 39, 56]
+ */
+
+VALUE
+rb_ary_first_set( VALUE ary, VALUE val)
+{
+    rb_ary_modify( ary);
+    long len = RARRAY_LEN( ary);
+    if (len == 0)
+        rb_raise( rb_eArgError, "cannot replace first element of an empty array");
+    RARRAY_ASET( ary, 0, val);
+    return val;
+}
+
+/*
+ *  call-seq:
+ *     last = obj  -> obj
+ *
+ *  Replace the last element. Equivalent to <code>ary[-1]=</code>.
+ *
+ *    a = [ 42, 39, -1]
+ *    a.last = 42
+ *    a                            #=> [42, 39, 42]
+ *    a.push 266
+ *    a.last /= 14
+ *    a                            #=> [42, 39, 42, 19]
+ */
+
+VALUE
+rb_ary_last_set( VALUE ary, VALUE val)
+{
+    rb_ary_modify( ary);
+    long len = RARRAY_LEN( ary);
+    if (len == 0)
+        rb_raise( rb_eArgError, "cannot replace last element of an empty array");
+    RARRAY_ASET( ary, len - 1, val);
+    return val;
+}
+
 
 /*
  *  call-seq:
@@ -1449,6 +1499,8 @@ void Init_supplement( void)
     rb_define_method( rb_cNumeric, "cbrt", rb_num_cbrt, 0);
 
     rb_define_method( rb_cArray, "notempty?", rb_ary_notempty_p, 0);
+    rb_define_method( rb_cArray, "first=", rb_ary_first_set, 1);
+    rb_define_method( rb_cArray, "last=", rb_ary_last_set, 1);
     rb_define_method( rb_cArray, "indexes", rb_ary_indexes, 0);
     rb_define_alias(  rb_cArray, "keys", "indexes");
     rb_define_method( rb_cArray, "range", rb_ary_range, 0);

data/lib/supplement.h

@@ -50,6 +50,8 @@ extern VALUE rb_num_sqrt( VALUE);
 extern VALUE rb_num_cbrt( VALUE);
 
 extern VALUE rb_ary_notempty_p( VALUE);
+extern VALUE rb_ary_first_set( VALUE, VALUE);
+extern VALUE rb_ary_last_set( VALUE, VALUE);
 extern VALUE rb_ary_indexes( VALUE);
 extern VALUE rb_ary_range( VALUE);
 extern VALUE rb_ary_pick(  int, VALUE *, VALUE);

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: supplement
 version: !ruby/object:Gem::Version
-  version: '2.22'
+  version: '2.24'
 platform: ruby
 authors:
 - Bertram Scharpf
 bindir: bin
 cert_chain: []
-date: 2025-01-04 00:00:00.000000000 Z
+date: 2025-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -91,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Ruby and the autorake gem
-rubygems_version: 3.6.2
+rubygems_version: 3.6.4
 specification_version: 4
 summary: Simple Ruby extensions
 test_files: []