From 0fd737e5551fc0dd7bf9d8536d539ef14de87197 Mon Sep 17 00:00:00 2001
From: github-actions <${GITHUB_ACTOR}@users.noreply.github.com>
Date: Thu, 3 Jun 2021 14:53:53 +0000
Subject: [PATCH] Formatted with Google Java Formatter
---
strings/HorspoolSearch.java | 286 +++++++++++++++++++-----------------
1 file changed, 148 insertions(+), 138 deletions(-)
diff --git a/strings/HorspoolSearch.java b/strings/HorspoolSearch.java
index 6e4d2e4e..694db017 100644
--- a/strings/HorspoolSearch.java
+++ b/strings/HorspoolSearch.java
@@ -3,160 +3,170 @@ package strings;
import java.util.HashMap;
/**
- * This class is not thread safe
- * (From wikipedia)
- * In computer science, the Boyer–Moore–Horspool algorithm or Horspool's algorithm is an algorithm for finding
- * substrings in strings. It was published by Nigel Horspool in 1980.
- * Wikipedia page
- *
- * An explanation:
- *
- * The Horspool algorithm is a simplification of the Boyer-Moore algorithm in that it uses only one of the two heuristic
- * methods for increasing the number of characters shifted when finding a bad match in the text. This method is usually
- * called the "bad symbol" or "bad character" shift. The bad symbol shift method is classified as an input enhancement
- * method in the theory of algorithms. Input enhancement is (from wikipedia) the principle that processing a given input
- * to a problem and altering it in a specific way will increase runtime efficiency or space efficiency, or both. Both
- * algorithms try to match the pattern and text comparing the pattern symbols to the text's from right to left.
- *
- * In the bad symbol shift method, a table is created prior to the search, called the "bad symbol table". The bad symbol
- * table contains the shift values for any symbol in the text and pattern. For these symbols, the value is the length of
- * the pattern, if the symbol is not in the first (length - 1) of the pattern. Else it is the distance from its
- * rightmost occurrence in the pattern to the last symbol of the pattern. In practice, we only calculate the values for
- * the ones that exist in the first (length - 1) of the pattern.
- *
- * For more details on the algorithm and the more advanced Boyer-Moore I recommend checking out the wikipedia page and
- * professor Anany Levitin's book: Introduction To The Design And Analysis Of Algorithms.
- *
+ * This class is not thread safe
+ *
+ * (From wikipedia) In computer science, the Boyer–Moore–Horspool algorithm or Horspool's algorithm
+ * is an algorithm for finding substrings in strings. It was published by Nigel Horspool in 1980.
+ *
+ * Wikipedia
+ * page
+ *
+ *
+ * An explanation:
+ *
+ *
The Horspool algorithm is a simplification of the Boyer-Moore algorithm in that it uses only
+ * one of the two heuristic methods for increasing the number of characters shifted when finding a
+ * bad match in the text. This method is usually called the "bad symbol" or "bad character" shift.
+ * The bad symbol shift method is classified as an input enhancement method in the theory of
+ * algorithms. Input enhancement is (from wikipedia) the principle that processing a given input to
+ * a problem and altering it in a specific way will increase runtime efficiency or space efficiency,
+ * or both. Both algorithms try to match the pattern and text comparing the pattern symbols to the
+ * text's from right to left.
+ *
+ *
+ *
In the bad symbol shift method, a table is created prior to the search, called the "bad symbol
+ * table". The bad symbol table contains the shift values for any symbol in the text and pattern.
+ * For these symbols, the value is the length of the pattern, if the symbol is not in the first
+ * (length - 1) of the pattern. Else it is the distance from its rightmost occurrence in the pattern
+ * to the last symbol of the pattern. In practice, we only calculate the values for the ones that
+ * exist in the first (length - 1) of the pattern.
+ *
+ *
+ *
For more details on the algorithm and the more advanced Boyer-Moore I recommend checking out
+ * the wikipedia page and professor Anany Levitin's book: Introduction To The Design And Analysis Of
+ * Algorithms.
*/
public class HorspoolSearch {
- private static HashMap shiftValues; // bad symbol table
- private static Integer patternLength;
- private static int comparisons = 0; // total comparisons in the current/last search
+ private static HashMap shiftValues; // bad symbol table
+ private static Integer patternLength;
+ private static int comparisons = 0; // total comparisons in the current/last search
- /**
- * Case sensitive version version of the algorithm
- *
- * @param pattern the pattern to be searched for (needle)
- * @param text the text being searched in (haystack)
- * @return -1 if not found or first index of the pattern in the text
- */
- public static int findFirst(String pattern, String text) {
- return firstOccurrence(pattern, text, true);
- }
+ /**
+ * Case sensitive version version of the algorithm
+ *
+ * @param pattern the pattern to be searched for (needle)
+ * @param text the text being searched in (haystack)
+ * @return -1 if not found or first index of the pattern in the text
+ */
+ public static int findFirst(String pattern, String text) {
+ return firstOccurrence(pattern, text, true);
+ }
- /**
- * Case insensitive version version of the algorithm
- *
- * @param pattern the pattern to be searched for (needle)
- * @param text the text being searched in (haystack)
- * @return -1 if not found or first index of the pattern in the text
- */
- public static int findFirstInsensitive(String pattern, String text) {
- return firstOccurrence(pattern, text, false);
- }
+ /**
+ * Case insensitive version version of the algorithm
+ *
+ * @param pattern the pattern to be searched for (needle)
+ * @param text the text being searched in (haystack)
+ * @return -1 if not found or first index of the pattern in the text
+ */
+ public static int findFirstInsensitive(String pattern, String text) {
+ return firstOccurrence(pattern, text, false);
+ }
- /**
- * Utility method that returns comparisons made by last run (mainly for tests)
- *
- * @return number of character comparisons of the last search
- */
- public static Integer getLastComparisons() {
- return HorspoolSearch.comparisons;
- }
+ /**
+ * Utility method that returns comparisons made by last run (mainly for tests)
+ *
+ * @return number of character comparisons of the last search
+ */
+ public static Integer getLastComparisons() {
+ return HorspoolSearch.comparisons;
+ }
- /**
- * Fairly standard implementation of the Horspool algorithm. Only the index of the last character of the pattern on the
- * text is saved and shifted by the appropriate amount when a mismatch is found. The algorithm stops at the first
- * match or when the entire text has been exhausted.
- *
- * @param pattern String to be matched in the text
- * @param text text String
- * @return index of first occurrence of the pattern in the text
- */
- private static int firstOccurrence(String pattern, String text, boolean caseSensitive) {
- shiftValues = calcShiftValues(pattern); // build the bad symbol table
- comparisons = 0; // reset comparisons
+ /**
+ * Fairly standard implementation of the Horspool algorithm. Only the index of the last character
+ * of the pattern on the text is saved and shifted by the appropriate amount when a mismatch is
+ * found. The algorithm stops at the first match or when the entire text has been exhausted.
+ *
+ * @param pattern String to be matched in the text
+ * @param text text String
+ * @return index of first occurrence of the pattern in the text
+ */
+ private static int firstOccurrence(String pattern, String text, boolean caseSensitive) {
+ shiftValues = calcShiftValues(pattern); // build the bad symbol table
+ comparisons = 0; // reset comparisons
- int textIndex = pattern.length() - 1; // align pattern with text start and get index of the last character
+ int textIndex =
+ pattern.length() - 1; // align pattern with text start and get index of the last character
- // while pattern is not out of text bounds
- while (textIndex < text.length()) {
+ // while pattern is not out of text bounds
+ while (textIndex < text.length()) {
- // try to match pattern with current part of the text starting from last character
- int i = pattern.length() - 1;
- while (i >= 0) {
- comparisons++;
- char patternChar = pattern.charAt(i);
- char textChar = text.charAt(
- (textIndex + i) - (pattern.length() - 1)
- );
- if (!charEquals(patternChar, textChar, caseSensitive)) { // bad character, shift pattern
- textIndex += getShiftValue(text.charAt(textIndex));
- break;
- }
- i--;
- }
-
- // check for full match
- if (i == -1) {
- return textIndex - pattern.length() + 1;
- }
+ // try to match pattern with current part of the text starting from last character
+ int i = pattern.length() - 1;
+ while (i >= 0) {
+ comparisons++;
+ char patternChar = pattern.charAt(i);
+ char textChar = text.charAt((textIndex + i) - (pattern.length() - 1));
+ if (!charEquals(patternChar, textChar, caseSensitive)) { // bad character, shift pattern
+ textIndex += getShiftValue(text.charAt(textIndex));
+ break;
}
+ i--;
+ }
- // text exhausted, return failure
- return -1;
+ // check for full match
+ if (i == -1) {
+ return textIndex - pattern.length() + 1;
+ }
}
- /**
- * Compares the argument characters
- *
- * @param c1 first character
- * @param c2 second character
- * @param caseSensitive boolean determining case sensitivity of comparison
- * @return truth value of the equality comparison
- */
- private static boolean charEquals(char c1, char c2, boolean caseSensitive) {
- if (caseSensitive) {
- return c1 == c2;
- }
- return Character.toLowerCase(c1) == Character.toLowerCase(c2);
+ // text exhausted, return failure
+ return -1;
+ }
+
+ /**
+ * Compares the argument characters
+ *
+ * @param c1 first character
+ * @param c2 second character
+ * @param caseSensitive boolean determining case sensitivity of comparison
+ * @return truth value of the equality comparison
+ */
+ private static boolean charEquals(char c1, char c2, boolean caseSensitive) {
+ if (caseSensitive) {
+ return c1 == c2;
+ }
+ return Character.toLowerCase(c1) == Character.toLowerCase(c2);
+ }
+
+ /**
+ * Builds the bad symbol table required to run the algorithm. The method starts from the second to
+ * last character of the pattern and moves to the left. When it meets a new character, it is by
+ * definition its rightmost occurrence and therefore puts the distance from the current index to
+ * the index of the last character into the table. If the character is already in the table, then
+ * it is not a rightmost occurrence, so it continues.
+ *
+ * @param pattern basis for the bad symbol table
+ * @return the bad symbol table
+ */
+ private static HashMap calcShiftValues(String pattern) {
+ patternLength = pattern.length();
+ HashMap table = new HashMap<>();
+
+ for (int i = pattern.length() - 2;
+ i >= 0;
+ i--) { // length - 2 is the index of the second to last character
+ char c = pattern.charAt(i);
+ int finalI = i;
+ table.computeIfAbsent(c, k -> pattern.length() - 1 - finalI);
}
- /**
- * Builds the bad symbol table required to run the algorithm. The method starts from the second to last character
- * of the pattern and moves to the left. When it meets a new character, it is by definition its rightmost occurrence
- * and therefore puts the distance from the current index to the index of the last character into the table. If the
- * character is already in the table, then it is not a rightmost occurrence, so it continues.
- *
- * @param pattern basis for the bad symbol table
- * @return the bad symbol table
- */
- private static HashMap calcShiftValues(String pattern) {
- patternLength = pattern.length();
- HashMap table = new HashMap<>();
+ return table;
+ }
- for (int i = pattern.length() - 2; i >= 0; i--) { // length - 2 is the index of the second to last character
- char c = pattern.charAt(i);
- int finalI = i;
- table.computeIfAbsent(c, k -> pattern.length() - 1 - finalI);
- }
-
- return table;
+ /**
+ * Helper function that uses the bad symbol shift table to return the appropriate shift value for
+ * a given character
+ *
+ * @param c character
+ * @return shift value that corresponds to the character argument
+ */
+ private static Integer getShiftValue(char c) {
+ if (shiftValues.get(c) != null) {
+ return shiftValues.get(c);
+ } else {
+ return patternLength;
}
-
- /**
- * Helper function that uses the bad symbol shift table to return the appropriate shift value for a given character
- *
- * @param c character
- * @return shift value that corresponds to the character argument
- */
- private static Integer getShiftValue(char c) {
- if (shiftValues.get(c) != null) {
- return shiftValues.get(c);
- } else {
- return patternLength;
- }
- }
-
+ }
}