added PermutationUnaryOperator

Author: cicirello

src/main/java/org/cicirello/permutations/Permutation.java

@@ -44,6 +44,8 @@ public final class Permutation implements Serializable, Iterable<Permutation>, C
 
 	private static final long serialVersionUID = 1L;
 
+	private final int[] permutation;
+	
 	/**
 	 * Initializes a random permutation of n integers.  Uses
 	 * java.util.concurrent.ThreadLocalRandom as the source of efficient random number generation.
@@ -205,6 +207,15 @@ public Permutation(Permutation p, int length) {
 		}
 	}
 
+	/**
+	 * Applies a custom unary operator on a Permutation object.
+	 *
+	 * @param operator A unary Permutation operator
+	 */
+	public void apply(PermutationUnaryOperator operator) {
+		operator.apply(permutation);
+	}
+	
 	/**
 	 * Creates an identical copy of this object.
 	 * @return an identical copy of this object
@@ -904,8 +915,6 @@ public int hashCode() {
 		return Arrays.hashCode(permutation);
 	}
 
-	private final int[] permutation;
-	
 	/**
 	 * <p>The Permutation.Mechanic class provides a means of adding application-specific
 	 * operations on Permutations without the need to directly alter the Permutation

src/main/java/org/cicirello/permutations/PermutationUnaryOperator.java

@@ -0,0 +1,45 @@
+/*
+ * JavaPermutationTools: A Java library for computation on permutations and sequences
+ * Copyright 2005-2022 Vincent A. Cicirello, <https://www.cicirello.org/>.
+ *
+ * This file is part of JavaPermutationTools (https://jpt.cicirello.org/).
+ *
+ * JavaPermutationTools is free software: you can 
+ * redistribute it and/or modify it under the terms of the GNU 
+ * General Public License as published by the Free Software 
+ * Foundation, either version 3 of the License, or (at your 
+ * option) any later version.
+ *
+ * JavaPermutationTools is distributed in the hope 
+ * that it will be useful, but WITHOUT ANY WARRANTY; without even 
+ * the implied warranty of MERCHANTABILITY or FITNESS FOR A 
+ * PARTICULAR PURPOSE.  See the GNU General Public License for more 
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with JavaPermutationTools.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.cicirello.permutations;
+
+/**
+ * A functional interface for defining custom unary operators on Permutations.
+ * See the {@link Permutation#apply(PermutationUnaryOperator)} method.
+ *
+ * @author <a href=https://www.cicirello.org/ target=_top>Vincent A. Cicirello</a>, 
+ * <a href=https://www.cicirello.org/ target=_top>https://www.cicirello.org/</a> 
+ */
+@FunctionalInterface
+public interface PermutationUnaryOperator {
+	
+	/**
+	 * Applies an operator on the raw representation of
+	 * a Permutation. Implementers of this interface are responsible
+	 * for ensuring that the apply method maintains a valid
+	 * permutation of the integers in {0, 1, ..., rawPermutation.length - 1 }.
+	 *
+	 * @param rawPermutation A reference to the raw array of ints underlying a
+	 * Permutation object. Changes to this array will directly change the Permutation
+	 * object that encapsulates it.
+	 */
+	void apply(int[] rawPermutation);
+}