From a8c841433fd6a8fa33eb99e2c2b52a2b54437db0 Mon Sep 17 00:00:00 2001
From: dearblue <dearblue@gmx.com>
Date: Tue, 5 May 2026 22:25:26 +0900
Subject: [PATCH] Rename the members of the `mrb_combination_state` structure

Since these are expressed as "nPk" or "nCk" in mathematics, rename `n` to `k` and `array_size` to `n`.
Additionally, rename the parameters `#__repeated_combination` and `#__combination_init` from `n` to `k`.

However, the parameter `n` in `#repeated_permutation` and `#repeated_combination` remains unchanged to align with CRuby.
---
 mrbgems/mruby-array-ext/mrblib/array.rb | 10 ++++----
 mrbgems/mruby-array-ext/src/array.c     | 33 ++++++++++++-------------
 2 files changed, 21 insertions(+), 22 deletions(-)

diff --git a/mrbgems/mruby-array-ext/mrblib/array.rb b/mrbgems/mruby-array-ext/mrblib/array.rb
index d81838338..a9cfa8a76 100644
--- a/mrbgems/mruby-array-ext/mrblib/array.rb
+++ b/mrbgems/mruby-array-ext/mrblib/array.rb
@@ -673,20 +673,20 @@ class Array
     __repeated_combination(n, true, &block)
   end
 
-  def __repeated_combination(n, permutation, &block)
-    n = n.__to_int
-    case n
+  def __repeated_combination(k, permutation, &block)
+    k = k.__to_int
+    case k
     when 0
       yield []
     when 1
-      # Keep fast Ruby path for n=1
+      # Keep fast Ruby path for k=1
       i = 0
       while i < self.size
         yield [self[i]]
         i += 1
       end
     else
-      if state = __combination_init(n, permutation)
+      if state = __combination_init(k, permutation)
         # Use C iterator for complex cases
         while tmp = __combination_next(state)
           yield tmp
diff --git a/mrbgems/mruby-array-ext/src/array.c b/mrbgems/mruby-array-ext/src/array.c
index 4ea183987..fb137d65f 100644
--- a/mrbgems/mruby-array-ext/src/array.c
+++ b/mrbgems/mruby-array-ext/src/array.c
@@ -32,8 +32,7 @@ typedef khash_t(ary_set) ary_set_t;
 /* Combination state structure for repeated_combination optimization */
 struct mrb_combination_state {
   mrb_int *indices;
-  mrb_int n;
-  mrb_int array_size;
+  mrb_int n, k; /* nPk, nCk */
   mrb_bool permutation;
   mrb_bool finished;
 };
@@ -1541,17 +1540,17 @@ ary_deconstruct(mrb_state *mrb, mrb_value ary)
 static mrb_value
 ary_combination_init(mrb_state *mrb, mrb_value self)
 {
-  mrb_int n;
+  mrb_int k;
   mrb_bool permutation;
 
-  mrb_get_args(mrb, "ib", &n, &permutation);
+  mrb_get_args(mrb, "ib", &k, &permutation);
 #if MRB_INT_MAX > SIZE_MAX
-  if (n > SIZE_MAX) {
+  if (k > SIZE_MAX) {
     mrb_raise(mrb, E_ARGUMENT_ERROR, "number too large");
   }
 #endif
 
-  if (n < 1 || RARRAY_LEN(self) < 1) {
+  if (k < 1 || RARRAY_LEN(self) < 1) {
     return mrb_nil_value();
   }
 
@@ -1560,11 +1559,11 @@ ary_combination_init(mrb_state *mrb, mrb_value self)
   Data_Make_Struct(mrb, mrb->object_class, struct mrb_combination_state,
                    &mrb_combination_state_type, state, d);
 
-  state->n = n;
-  state->array_size = RARRAY_LEN(self);
+  state->k = k;
+  state->n = RARRAY_LEN(self);
   state->permutation = permutation;
   state->finished = FALSE;
-  state->indices = (mrb_int*)mrb_calloc(mrb, n, sizeof(mrb_int));
+  state->indices = (mrb_int*)mrb_calloc(mrb, k, sizeof(mrb_int));
 
   return mrb_obj_value(d);
 }
@@ -1583,30 +1582,30 @@ ary_combination_next(mrb_state *mrb, mrb_value self)
   if (state->finished) return mrb_nil_value();
 
   /* Validate array hasn't been modified during iteration */
-  if (RARRAY_LEN(self) != state->array_size) {
+  if (RARRAY_LEN(self) != state->n) {
     mrb_raise(mrb, E_RUNTIME_ERROR, "array modified during iteration");
   }
 
   /* Validate current indices are still in bounds */
-  for (mrb_int i = 0; i < state->n; i++) {
-    if (state->indices[i] >= state->array_size) {
+  for (mrb_int i = 0; i < state->k; i++) {
+    if (state->indices[i] >= state->n) {
       state->finished = TRUE;
       return mrb_nil_value();
     }
   }
 
   /* Build current combination */
-  mrb_value result = mrb_ary_new_capa(mrb, state->n);
+  mrb_value result = mrb_ary_new_capa(mrb, state->k);
   const mrb_value *p = RARRAY_PTR(self);
-  for (mrb_int i = 0; i < state->n; i++) {
+  for (mrb_int i = 0; i < state->k; i++) {
     mrb_ary_push(mrb, result, p[state->indices[i]]);
   }
 
-  mrb_int pos = state->n - 1;
+  mrb_int pos = state->k - 1;
 
   while (pos >= 0) {
     state->indices[pos]++;
-    if (state->indices[pos] < state->array_size) break;
+    if (state->indices[pos] < state->n) break;
     pos--;
   }
 
@@ -1616,7 +1615,7 @@ ary_combination_next(mrb_state *mrb, mrb_value self)
   else {
     /* Reset dependent indices */
     mrb_int reset = state->permutation ? 0 : state->indices[pos];
-    for (pos++; pos < state->n; pos++) {
+    for (pos++; pos < state->k; pos++) {
       state->indices[pos] = reset;
     }
   }