Handle advancing with possibile sub-character end.

When searching in a substring with an endIndex that isn't on a character boundary,
advancing from the penultimate character position to the substring's endIndex can end
up failing, since advancing by a character finds the character-aligned index that is
_past_ the substring end. This change handles that case.

Author: natecook1000

Sources/_StringProcessing/Engine/Processor.swift

@@ -175,14 +175,25 @@ extension Processor {
   // save point was restored
   mutating func consume(_ n: Distance) -> Bool {
     // TODO: needs benchmark coverage
-    guard let idx = input.index(
+    if let idx = input.index(
       currentPosition, offsetBy: n.rawValue, limitedBy: end
-    ) else {
-      signalFailure()
-      return false
+    ) {
+      currentPosition = idx
+      return true
     }
-    currentPosition = idx
-    return true
+
+    // If `end` falls in the middle of a character, and we are trying to advance
+    // by one "character", then we should max out at `end` even though the above
+    // advancement will result in `nil`.
+    if n == 1, let idx = input.unicodeScalars.index(
+      currentPosition, offsetBy: n.rawValue, limitedBy: end
+    ) {
+      currentPosition = idx
+      return true
+    }
+
+    signalFailure()
+    return false
   }
 
   // Advances in unicode scalar view