Package Torello.Java

Class StrCmpr

  • public class StrCmpr
extends java.lang.Object
    Class String-Compare provides an exhaustive-combinatoric suite of methods that extend the basic Java String methods equals, contains, startsWith and endsWith.

    This class offers an API that has a large collection of comparison routines for a java.lang.String.

    Obviously, Regular-Expressions will always be capable of providing the most powerful String-Search and manipulations routines. However, with the extra level of control that a Regular-Expression offers comes some extra-amount of complexity. The routines in class StrCmpr and class StrIndexOf can eliminate for-loops and all the debugging that comes along with them - saving programmers countless hours of when their programs need only simple comparisons and searches that can be written without a RegEx.

    The methods in this class use substring comparison-logic, rather than token compares - meaning that the loops are checking only the characters within input parameter(s) comparStr. The characters before and after a match are ignored.

    Example:
    boolean result = StrCmpr.containsXOR_CI("Visited in August of this year." "july", "august");
// Evaluates to TRUE

boolean result = StrCmpr.containsXOR_CI("Traveled to Beijing last year.", "july", "august");
// Evaluates to FALSE

    Methods Available

    Method-Name Key-Word Explanation
    NAND May not find any matches between the primary String srcStr parameter, and the String's passed to 'compareStr'

    NAND-NOTE: There is one very important subtlety about the meaning of 'NAND' here. In this case, the methods that use 'NAND' interpret its meaning as "NOT ANY ONE OF..." - meaning all comparisons must fail.
    XOR Must find precisely one match between the primary String srcStr parameter, and the String's in 'compareStr'.

    There is one 'philosophical note' which is that if multiple copies of an identical-String are passed via the comparison-Stringarray (String... comparestr), all XOR methods shall not pay heed to the notion that they the 'srcStr' parmeter may have only started-with, ended-with or contained a single String (and 'philosophically passing' the XOR, one-and-only-one test). The internal-logical is 'programmatically ignorant' of this - multiple copies of an identical-String (or identical, ignoring-case) could theoretically be flagged via throwing an IllegalArgumentException. However, no such check is performed.
    OR Must find at least one match between the primary String srcStr parameter, and the String's in the 'compareStr' parameter.
    AND Must identify a containing-match between each and every String in String... compareStr and the primary 'srcStr' parameter.
    Starts With The provided compare-String (or String's) must match the beginning of parameter 'srcStr'.
    Ends With The provided compare-String (or String's) must match the ending of parameter 'srcStr'.
    Contains The provided compare-String (or String's) must be a substring of parameter 'srcStr'.
    CI (Case Insensitive) All equality-tests will be done on a Case Insensitive basis.



    Stateless Class:
    This class neither contains any program-state, nor can it be instantiated. The @StaticFunctional Annotation may also be called 'The Spaghetti Report'. Static-Functional classes are, essentially, C-Styled Files, without any constructors or non-static member fields. It is a concept very similar to the Java-Bean's @Stateless Annotation.

    • 1 Constructor(s), 1 declared private, zero-argument constructor
    • 56 Method(s), 56 declared static
    • 6 Field(s), 6 declared static, 4 declared final
    • Fields excused from final modifier (with explanation):
      Field 'DEBUG' is not final. Reason: DEBUGGING
      Field 'DEBUG_LOG' is not final. Reason: DEBUGGING


    • Field Summary

       
      Simple Debug Printing Fields
      Modifier and Type Field
      static boolean DEBUG
      static Consumer<String> DEBUG_LOG
       
      Internal, Protected Helper Fields
      Modifier and Type Field
      protected static byte AND
      protected static byte NAND
      protected static byte OR
      protected static byte XOR

    • Method Summary

       
      Equals
      Modifier and Type Method
      static boolean equalsNAND​(String srcStr, String... compareStr)
      static boolean equalsXOR​(String srcStr, String... compareStr)
       
      Equals: Ⅰ Range-Limited
      Modifier and Type Method
      static boolean equals​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean equalsNAND​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean equalsXOR​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Equals: Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean equalsNAND_CI​(String srcStr, String... compareStr)
      static boolean equalsXOR_CI​(String srcStr, String... compareStr)
       
      Equals: Ⅰ Range-Limited Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean equalsIgnoreCase​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean equalsNAND_CI​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean equalsXOR_CI​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Contains
      Modifier and Type Method
      static boolean containsAND​(String srcStr, String... compareStr)
      static boolean containsNAND​(String srcStr, String... compareStr)
      static boolean containsOR​(String srcStr, String... compareStr)
      static boolean containsXOR​(String srcStr, String... compareStr)
       
      Contains: Ⅰ Range-Limited
      Modifier and Type Method
      static boolean contains​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean containsAND​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean containsNAND​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean containsOR​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean containsXOR​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Contains: Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean containsAND_CI​(String srcStr, String... compareStr)
      static boolean containsIgnoreCase​(String srcStr, String compareStr)
      static boolean containsNAND_CI​(String srcStr, String... compareStr)
      static boolean containsOR_CI​(String srcStr, String... compareStr)
      static boolean containsXOR_CI​(String srcStr, String... compareStr)
       
      Contains: Ⅰ Range-Limited Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean containsAND_CI​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean containsIgnoreCase​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean containsNAND_CI​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean containsOR_CI​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean containsXOR_CI​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Starts-With
      Modifier and Type Method
      static boolean startsWithNAND​(String srcStr, String... compareStr)
      static boolean startsWithXOR​(String srcStr, String... compareStr)
       
      Starts-With: Ⅰ Range-Limited
      Modifier and Type Method
      static boolean startsWith​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean startsWithNAND​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean startsWithXOR​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Starts-With: Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean startsWithIgnoreCase​(String srcStr, String compareStr)
      static boolean startsWithNAND_CI​(String srcStr, String... compareStr)
      static boolean startsWithXOR_CI​(String srcStr, String... compareStr)
       
      Starts-With: Ⅰ Range-Limited Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean startsWithIgnoreCase​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean startsWithNAND_CI​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean startsWithXOR_CI​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Ends-With
      Modifier and Type Method
      static boolean endsWithNAND​(String srcStr, String... compareStr)
      static boolean endsWithXOR​(String srcStr, String... compareStr)
       
      Ends-With: Ⅰ Range-Limited
      Modifier and Type Method
      static boolean endsWith​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean endsWithNAND​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean endsWithXOR​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Ends-With: Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean endsWithIgnoreCase​(String srcStr, String compareStr)
      static boolean endsWithNAND_CI​(String srcStr, String... compareStr)
      static boolean endsWithXOR_CI​(String srcStr, String... compareStr)
       
      Ends-With: Ⅰ Range-Limited Ⅱ Case-Insensitive
      Modifier and Type Method
      static boolean endsWithIgnoreCase​(String srcStr, int sPos, int ePos, String compareStr)
      static boolean endsWithNAND_CI​(String srcStr, int sPos, int ePos, String... compareStr)
      static boolean endsWithXOR_CI​(String srcStr, int sPos, int ePos, String... compareStr)
       
      Internal, Protected Helper Methods
      Modifier and Type Method
      protected static boolean AND​(String methodName, String srcStr, String[] compareStr, Predicate<String> pred)
      protected static boolean NAND​(String methodName, String srcStr, String[] compareStr, Predicate<String> pred)
      protected static boolean OR​(String methodName, String srcStr, String[] compareStr, Predicate<String> pred)
      protected static boolean XOR​(String methodName, String srcStr, String[] compareStr, Predicate<String> pred)

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • DEBUG

        🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean DEBUG
        Utility field. You may choose to set this variable to true, and the following String commands will print to an internally stored Consumer<String> DEBUG_LOG class that may be set. This is generally a very minor drain on code-efficiency. When this flag is set to FALSE, a short if-statement evaluation still occurs even when the flag is false on each occasion that the string-comparison loops identify and return a match. This is very minor performance loss, and does provide quite a lot of help to those trying to identify difficult to notice problems with partial-String comparisons.

        Required Setting:
        In order to use this minor Debugging Feature, it is necessary to provide a Consumer<String> to public field DEBUG_LOG! This field is a public and static field, which will be used by any invocation of the methods in this class. This String-consumer may do anything you would like it to do with the provided Debug-String data.

        String-Format:
        The String that is ultimately sent to the Consumer<String> you provide will be formatted, as below, in the following Code-Snippet: 

         private static void PRNT(String methodName, String srcStr, String compareStr)
 { DEBUG_LOG.accept(methodName + "-MATCH[" + srcStr + ", " + compareStr + "] "); }


        Generally, you would assign a writer that looks like something the Lambda-Target / Function-Pointer assignment in the snippet below: 

         StrCmpr.DEBUG_LOG = (String logInfoStr) -> System.out.println(logInfoStr);


        Finally, if you are using this field, please note that any of the methods whose name ends with the phrase "IgnoreCase" will not print to the DEBUG_LOG. This is primarily because these are all single-argument comparisons, and logging would be of only minor benefit.

        The primary value of a debug-log is the ability to identify whether / when a particular substring from a list of substrings actually matched.
        Code:
        Exact Field Declaration Expression:
         public static boolean DEBUG = false;

      • DEBUG_LOG

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static java.util.function.Consumer<java.lang.String> DEBUG_LOG
        This object reference cannot remain null when the field DEBUG is set to TRUE. If you have turned DEBUG on (by setting the field to TRUE), and this is null, then a NullPointerException will be thrown on the very next invocation of any of the methods in this class.

        DEBUG_LOG is not Thread-Safe:
        No attempt has been made to ensure that this debugging "feature" will operate perfectly in a multi-threaded environment. The two reasons for this are:

        1. The primary purpose of this LOG is for debugging code, not putting details about string-match information into an 'on-line' or production environment.

        2. This is a best-efforts string-comparison package that would sacrifice quite a bit of its utility if it were expected to maintain multiple instances of this class just to have StrCmpr debug operations work in multiple-threads. Code readability necessitates keeping this a class with only static methods.

        3. Two threads making calls to this class StrCmpr might see log-writes that, sadly, look like they 'interlaced' (crashed), but even when this occasions, reading the log wouldn't be that difficult anyway.
        Code:
        Exact Field Declaration Expression:
         public static Consumer<String> DEBUG_LOG = null;

      • AND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static final byte AND
        Signifies that an 'AND' operation is required, but only for methods that implement one of the 'contains' variants.
        See Also:
        Constant Field Values
        Code:
        Exact Field Declaration Expression:
         protected static final byte AND = 0;

      • OR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static final byte OR
        Signifies that an 'AND' operation is required, but only for methods that implement one of the 'contains' variants.
        See Also:
        Constant Field Values
        Code:
        Exact Field Declaration Expression:
         protected static final byte OR = 1;

      • NAND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static final byte NAND
        Signifies that an 'AND' operation is required, but only for methods that implement one of the 'contains' variants.
        See Also:
        Constant Field Values
        Code:
        Exact Field Declaration Expression:
         protected static final byte NAND = 2;

      • XOR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static final byte XOR
        Signifies that an 'AND' operation is required, but only for methods that implement one of the 'contains' variants.
        See Also:
        Constant Field Values
        Code:
        Exact Field Declaration Expression:
         protected static final byte XOR = 3;

    • Method Detail

      • AND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static boolean AND​
            (java.lang.String methodName,
             java.lang.String srcStr,
             java.lang.String[] compareStr,
             java.util.function.Predicate<java.lang.String> pred)
        This performs the internal AND. It expects a comparison Predicate in order for the comparison to work.
        Parameters:
        methodName - If printing-debug information is expected, by the DEBUG global-variable, this String is used.
        srcStr - This is the same source-string parameter from all the methods in this class.
        compareStr - This is the same var-args string array from all the methods in this class.
        pred - This is the comparison Predicate provided by the methods in this class that call this method.
        Returns:
        The AND of these String's, using the provided Predicate.
        Throws:
        StrCmprException - This exception shall throw if there are any invalid String's in the compare-string parameter array.

        Note: The conditions that would cause this exception to throw should remind the reader that each and every method here will throw exception 'StrCmprException' if invalid input has been passed to the "Compare String" Variable-Arguments String... Parameter.
        Code:
        Exact Method Body:
         StrCmprException.check(compareStr);

 for (String cmp: compareStr)

     if (! pred.test(cmp))
     {
         if (DEBUG) PRNT(methodName + "-MATCHFAIL", srcStr, cmp);
         return false;
     }

 return true;

      • NAND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static boolean NAND​
            (java.lang.String methodName,
             java.lang.String srcStr,
             java.lang.String[] compareStr,
             java.util.function.Predicate<java.lang.String> pred)
        This performs the internal NAND. It expects a comparison Predicate in order for the comparison to work.
        Parameters:
        methodName - If printing-debug information is expected, by the DEBUG global-variable, this String is used.
        srcStr - This is the same source-string parameter from all the methods in this class.
        compareStr - This is the same var-args string array from all the methods in this class.
        pred - This is the comparison Predicate provided by the methods in this class that call this method.
        Returns:
        The NAND of these String's, using the provided Predicate.
        Throws:
        StrCmprException - This exception shall throw if there are any invalid String's in the compare-string parameter array.

        Note: The conditions that would cause this exception to throw should remind the reader that each and every method here will throw exception 'StrCmprException' if invalid input has been passed to the "Compare String" Variable-Arguments String... Parameter.
        Code:
        Exact Method Body:
         StrCmprException.check(compareStr); 

 for (String cmp: compareStr)

     if (pred.test(cmp))
     {
         if (DEBUG) PRNT(methodName + "-MATCH", srcStr, cmp);
         return false;
     }

 return true;

      • OR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static boolean OR​
            (java.lang.String methodName,
             java.lang.String srcStr,
             java.lang.String[] compareStr,
             java.util.function.Predicate<java.lang.String> pred)
        This performs the internal OR. It expects a comparison Predicate in order for the comparison to work.
        Parameters:
        methodName - If printing-debug information is expected, by the DEBUG global-variable, this String is used.
        srcStr - This is the same source-string parameter from all the methods in this class.
        compareStr - This is the same var-args string array from all the methods in this class.
        pred - This is the comparison Predicate provided by the methods in this class that call this method.
        Returns:
        The OR of these String's, using the provided Predicate.
        Throws:
        StrCmprException - This exception shall throw if there are any invalid String's in the compare-string parameter array.

        Note: The conditions that would cause this exception to throw should remind the reader that each and every method here will throw exception 'StrCmprException' if invalid input has been passed to the "Compare String" Variable-Arguments String... Parameter.
        Code:
        Exact Method Body:
         StrCmprException.check(compareStr);

 for (String cmp: compareStr)

     if (pred.test(cmp))
     {
         if (DEBUG) PRNT(methodName + "-MATCH", srcStr, cmp);
         return true;
     }

 return false;

      • XOR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        protected static boolean XOR​
            (java.lang.String methodName,
             java.lang.String srcStr,
             java.lang.String[] compareStr,
             java.util.function.Predicate<java.lang.String> pred)
        This performs the internal XOR. It expects a comparison Predicate in order for the comparison to work.
        Parameters:
        methodName - If printing-debug information is expected, by the DEBUG global-variable, this String is used.
        srcStr - This is the same source-string parameter from all the methods in this class.
        compareStr - This is the same var-args string array from all the methods in this class.
        pred - This is the comparison Predicate provided by the methods in this class that call this method.
        Returns:
        The XOR of these String's, using the provided Predicate.
        Throws:
        StrCmprException - This exception shall throw if there are any invalid String's in the compare-string parameter array.

        Note: The conditions that would cause this exception to throw should remind the reader that each and every method here will throw exception 'StrCmprException' if invalid input has been passed to the "Compare String" Variable-Arguments String... Parameter.
        Code:
        Exact Method Body:
         StrCmprException.check(compareStr); 

 int count=0;

 for (String cmp: compareStr)

     if (pred.test(cmp))

         if (++count > 1)
         {
             if (DEBUG) PRNT(methodName + "-MATCH", srcStr, cmp);
             return false;
         }

 return count == 1;

      • equalsXOR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean equalsXOR​(java.lang.String srcStr,
                                java.lang.String... compareStr)
        Checks to ensure that srcStr equals exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr equals exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return XOR("equalsXOR", srcStr, compareStr, cmp -> srcStr.equals(cmp));

      • equalsNAND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean equalsNAND​(java.lang.String srcStr,
                                 java.lang.String... compareStr)
        Checks to ensure that srcStr does not equal any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not equal any of the 'compareStr' instances (and FALSE otherwise).
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return NAND("equalsNAND", srcStr, compareStr, cmp -> srcStr.equals(cmp));

      • equalsXOR_CI

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean equalsXOR_CI​(java.lang.String srcStr,
                                   java.lang.String... compareStr)
        Checks to ensure that srcStr equals exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr equals exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return XOR("equalsXOR_CI", srcStr, compareStr, cmp -> srcStr.equalsIgnoreCase(cmp));

      • equalsNAND_CI

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean equalsNAND_CI​(java.lang.String srcStr,
                                    java.lang.String... compareStr)
        Checks to ensure that srcStr does not equal any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not equal any of the 'compareStr' instances (and FALSE otherwise).
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return NAND("equalsNAND_CI", srcStr, compareStr, cmp -> srcStr.equalsIgnoreCase(cmp));

      • containsOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsOR​(java.lang.String srcStr,
                                 java.lang.String... compareStr)
        Checks to ensure that srcStr contains at least one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr contains at least one of the 'compareStr' instances (and FALSE otherwise).
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(false, OR, srcStr, compareStr);

      • containsAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsAND​(java.lang.String srcStr,
                                  java.lang.String... compareStr)
        Checks to ensure that srcStr contains every one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr contains every one of the 'compareStr' instances (and FALSE otherwise).
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(false, AND, srcStr, compareStr);

      • containsXOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsXOR​(java.lang.String srcStr,
                                  java.lang.String... compareStr)
        Checks to ensure that srcStr contains exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr contains exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(false, XOR, srcStr, compareStr);

      • containsNAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsNAND​(java.lang.String srcStr,
                                   java.lang.String... compareStr)
        Checks to ensure that srcStr does not contain any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not contain any of the 'compareStr' instances (and FALSE otherwise).
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(false, NAND, srcStr, compareStr);

      • containsOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsOR_CI​(java.lang.String srcStr,
                                    java.lang.String... compareStr)
        Checks to ensure that srcStr contains at least one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr contains at least one of the 'compareStr' instances (and FALSE otherwise).
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(true, OR, srcStr, compareStr);

      • containsAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsAND_CI​(java.lang.String srcStr,
                                     java.lang.String... compareStr)
        Checks to ensure that srcStr contains every one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr contains every one of the 'compareStr' instances (and FALSE otherwise).
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(true, AND, srcStr, compareStr);

      • containsXOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsXOR_CI​(java.lang.String srcStr,
                                     java.lang.String... compareStr)
        Checks to ensure that srcStr contains exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr contains exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(true, XOR, srcStr, compareStr);

      • containsNAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsNAND_CI​(java.lang.String srcStr,
                                      java.lang.String... compareStr)
        Checks to ensure that srcStr does not contain any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not contain any of the 'compareStr' instances (and FALSE otherwise).
        Code:
        Exact Method Body:
         return CmprCN.CONTAINS(true, NAND, srcStr, compareStr);

      • endsWithXOR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean endsWithXOR​(java.lang.String srcStr,
                                  java.lang.String... compareStr)
        Checks to ensure that srcStr ends with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr ends with exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return XOR("endsWithXOR", srcStr, compareStr, cmp -> srcStr.endsWith(cmp));

      • endsWithNAND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean endsWithNAND​(java.lang.String srcStr,
                                   java.lang.String... compareStr)
        Checks to ensure that srcStr does not end with any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not end with any of the 'compareStr' instances (and FALSE otherwise).
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return NAND("endsWithNAND", srcStr, compareStr, cmp -> srcStr.endsWith(cmp));

      • startsWithXOR

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean startsWithXOR​(java.lang.String srcStr,
                                    java.lang.String... compareStr)
        Checks to ensure that srcStr starts with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr starts with exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return XOR("startsWithXOR", srcStr, compareStr, cmp -> srcStr.startsWith(cmp));

      • startsWithNAND

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean startsWithNAND​(java.lang.String srcStr,
                                     java.lang.String... compareStr)
        Checks to ensure that srcStr does not start with any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not start with any of the 'compareStr' instances (and FALSE otherwise).
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return NAND("startsWithNAND", srcStr, compareStr, cmp -> srcStr.startsWith(cmp));

      • endsWithXOR_CI

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean endsWithXOR_CI​(java.lang.String srcStr,
                                     java.lang.String... compareStr)
        Checks to ensure that srcStr ends with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr ends with exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        endsWithIgnoreCase(String, String), XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return XOR("endsWithXOR_CI", srcStr, compareStr, cmp -> endsWithIgnoreCase(srcStr, cmp));

      • endsWithNAND_CI

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean endsWithNAND_CI​(java.lang.String srcStr,
                                      java.lang.String... compareStr)
        Checks to ensure that srcStr does not end with any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not end with any of the 'compareStr' instances (and FALSE otherwise).
        See Also:
        endsWithIgnoreCase(String, String), NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return NAND("endsWithNAND_CI", srcStr, compareStr, cmp -> endsWithIgnoreCase(srcStr, cmp));

      • startsWithXOR_CI

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean startsWithXOR_CI​(java.lang.String srcStr,
                                       java.lang.String... compareStr)
        Checks to ensure that srcStr starts with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr starts with exactly one of the 'compareStr' instances (and FALSE otherwise).

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        startsWithIgnoreCase(String, String), XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return XOR(
     "startsWithXOR_CI", srcStr, compareStr,
     cmp -> startsWithIgnoreCase(srcStr, cmp)
 );

      • startsWithNAND_CI

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean startsWithNAND_CI​(java.lang.String srcStr,
                                        java.lang.String... compareStr)
        Checks to ensure that srcStr does not start with any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if srcStr does not start with any of the 'compareStr' instances (and FALSE otherwise).
        See Also:
        startsWithIgnoreCase(String, String), NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         return NAND(
     "startsWithNAND_CI", srcStr, compareStr,
     cmp -> startsWithIgnoreCase(srcStr, cmp)
 );

      • startsWithIgnoreCase

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean startsWithIgnoreCase​(java.lang.String srcStr,
                                           java.lang.String compareStr)
        This performs the exact same comparison as Java's String.startsWith(String) method. Java provides an 'equalsIgnoreCase()' method, but not an 'startsWithIgnoreCase()'. This method does just that.
        Parameters:
        srcStr - This String is checked to see if it starts with the compareStr.
        compareStr - This String is checked against the srcStr - specifically, if srcStr ends with compareStr
        Returns:
        TRUE if srcStr starts with compareStr (ignoring-case), and FALSE otherwise.
        Code:
        Exact Method Body:
         return srcStr.regionMatches(true, 0, compareStr, 0, compareStr.length());

      • endsWithIgnoreCase

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static boolean endsWithIgnoreCase​(java.lang.String srcStr,
                                         java.lang.String compareStr)
        This performs the exact same comparison as Java's String.endsWith(String) method. Java provides an 'equalsIgnoreCase()' method, but not an 'endsWithIgnoreCase()'. This method does just that.
        Parameters:
        srcStr - This String is checked to see if it ends with the compareStr.
        compareStr - This String is checked against the srcStr - specifically, if srcStr ends with compareStr
        Returns:
        TRUE if srcStr ends with compareStr (ignoring-case), and FALSE otherwise.
        Code:
        Exact Method Body:
         final int compareStrLen = compareStr.length();
 final int srcStrLen     = srcStr.length();

 return srcStr.regionMatches(true, srcStrLen - compareStrLen, compareStr, 0, compareStrLen);

      • containsIgnoreCase

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsIgnoreCase​(java.lang.String srcStr,
                                         java.lang.String compareStr)
        This performs the exact same comparison as Java's String.contains(String) method. Java provides an 'equalsIgnoreCase()' method, but not a 'containsIgnoreCase()'. This method does just that.
        Parameters:
        srcStr - This String is checked to see if it contains the compareStr
        compareStr - This String is checked against the srcStr - specifically, if compareStr is contained by srcStr
        Returns:
        TRUE if compareStr is a substring of srcStr (ignoring-case), and FALSE otherwise.
        Code:
        Exact Method Body:
         return CmprCN.containsIgnoreCase(srcStr, new LV(srcStr, 0, srcStr.length()), compareStr);

      • equalsXOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean equalsXOR​(java.lang.String srcStr,
                                int sPos,
                                int ePos,
                                java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - equals exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') equals exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return XOR("equalsXOR", srcStr, compareStr, cmp -> CmprEQ.eq(srcStr, l, cmp));

      • equalsNAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean equalsNAND​(java.lang.String srcStr,
                                 int sPos,
                                 int ePos,
                                 java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not equal any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not equal any of the 'compareStr' values.
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return NAND("equalsNAND", srcStr, compareStr, cmp -> CmprEQ.eq(srcStr, l, cmp));

      • equalsXOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean equalsXOR_CI​(java.lang.String srcStr,
                                   int sPos,
                                   int ePos,
                                   java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - equals exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') equals exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return XOR("equalsXOR_CI", srcStr, compareStr, cmp -> CmprEQ.eq_CI(srcStr, l, cmp));

      • equalsNAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean equalsNAND_CI​(java.lang.String srcStr,
                                    int sPos,
                                    int ePos,
                                    java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not equal any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not equal any of the 'compareStr' values.
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return NAND("equalsNAND_CI", srcStr, compareStr, cmp -> CmprEQ.eq_CI(srcStr, l, cmp));

      • containsOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsOR​(java.lang.String srcStr,
                                 int sPos,
                                 int ePos,
                                 java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - contains at least one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains at least one of the 'compareStr' values.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(false, OR, l, srcStr, compareStr);

      • containsAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsAND​(java.lang.String srcStr,
                                  int sPos,
                                  int ePos,
                                  java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - contains every one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains every one of the 'compareStr' values.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(false, AND, l, srcStr, compareStr);

      • containsXOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsXOR​(java.lang.String srcStr,
                                  int sPos,
                                  int ePos,
                                  java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - contains exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(false, XOR, l, srcStr, compareStr);

      • containsNAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsNAND​(java.lang.String srcStr,
                                   int sPos,
                                   int ePos,
                                   java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not contain any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not contain any of the 'compareStr' values.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(false, NAND, l, srcStr, compareStr);

      • containsOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsOR_CI​(java.lang.String srcStr,
                                    int sPos,
                                    int ePos,
                                    java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - contains at least one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains at least one of the 'compareStr' values.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(true, OR, l, srcStr, compareStr);

      • containsAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsAND_CI​(java.lang.String srcStr,
                                     int sPos,
                                     int ePos,
                                     java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - contains every one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains every one of the 'compareStr' values.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(true, AND, l, srcStr, compareStr);

      • containsXOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsXOR_CI​(java.lang.String srcStr,
                                     int sPos,
                                     int ePos,
                                     java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - contains exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(true, XOR, l, srcStr, compareStr);

      • containsNAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsNAND_CI​(java.lang.String srcStr,
                                      int sPos,
                                      int ePos,
                                      java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not contain any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not contain any of the 'compareStr' values.
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return CmprCN.CONTAINS(true, NAND, l, srcStr, compareStr);

      • endsWithXOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean endsWithXOR​(java.lang.String srcStr,
                                  int sPos,
                                  int ePos,
                                  java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - ends with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') ends with exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return XOR("endsWithXOR", srcStr, compareStr, cmp -> CmprEW.ew(srcStr, l, cmp));

      • endsWithNAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean endsWithNAND​(java.lang.String srcStr,
                                   int sPos,
                                   int ePos,
                                   java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not end with any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not end with any of the 'compareStr' values.
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return NAND("endsWithNAND", srcStr, compareStr, cmp -> CmprEW.ew(srcStr, l, cmp));

      • startsWithXOR

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean startsWithXOR​(java.lang.String srcStr,
                                    int sPos,
                                    int ePos,
                                    java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - starts with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') starts with exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return XOR("startsWithXOR", srcStr, compareStr, cmp -> CmprSW.sw(srcStr, l, cmp));

      • startsWithNAND

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean startsWithNAND​(java.lang.String srcStr,
                                     int sPos,
                                     int ePos,
                                     java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not start with any of the String's inside the 'compareStr' array.

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not start with any of the 'compareStr' values.
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return NAND("startsWithNAND", srcStr, compareStr, cmp -> CmprSW.sw(srcStr, l, cmp));

      • endsWithXOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean endsWithXOR_CI​(java.lang.String srcStr,
                                     int sPos,
                                     int ePos,
                                     java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - ends with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') ends with exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return XOR("endsWithXOR_CI", srcStr, compareStr, cmp -> CmprEW.ew_CI(srcStr, l, cmp));

      • endsWithNAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean endsWithNAND_CI​(java.lang.String srcStr,
                                      int sPos,
                                      int ePos,
                                      java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not end with any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not end with any of the 'compareStr' values.
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return NAND("endsWithNAND_CI", srcStr, compareStr, cmp -> CmprEW.ew_CI(srcStr, l, cmp));

      • startsWithXOR_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean startsWithXOR_CI​(java.lang.String srcStr,
                                       int sPos,
                                       int ePos,
                                       java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - starts with exactly one of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') starts with exactly one of the 'compareStr' values.

        An internal counter is maintained, and it must equal precisely one prior to exit in order for TRUE to be returned. In the case that multiple copies of an identical String have been passed into parameter String[] compareStr, the returned-answer is best considered non-deterministic.. In practice, a second copy of an identical-String (or identical-ignoring case) will force the XOR comparison to return FALSE

        Note: No exception checks are performed on compareStr for duplicate elements in that array. This check is avoied essentially due to the performance over-head of checking for it.
        See Also:
        XOR(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return XOR("startsWithXOR_CI", srcStr, compareStr, cmp -> CmprSW.sw_CI(srcStr, l, cmp));

      • startsWithNAND_CI

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean startsWithNAND_CI​(java.lang.String srcStr,
                                        int sPos,
                                        int ePos,
                                        java.lang.String... compareStr)
        Checks to ensure the substring of srcStr - demarcated by the parameters 'sPos' (inclusive) and 'ePos' (exclusive) - does not start with any of the String's inside the 'compareStr' array.

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String's used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') does not start with any of the 'compareStr' values.
        See Also:
        NAND(String, String, String[], Predicate)
        Code:
        Exact Method Body:
         final LV l = new LV(srcStr, sPos, ePos);
 return NAND("startsWithNAND_CI", srcStr, compareStr, cmp -> CmprSW.sw_CI(srcStr, l, cmp));

      • equals

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean equals​(java.lang.String srcStr,
                             int sPos,
                             int ePos,
                             java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' equals 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') equals 'compareStr'
        Code:
        Exact Method Body:
         return CmprEQ.eq(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • equalsIgnoreCase

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean equalsIgnoreCase​(java.lang.String srcStr,
                                       int sPos,
                                       int ePos,
                                       java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' equals 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') equals 'compareStr'
        Code:
        Exact Method Body:
         return CmprEQ.eq_CI(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • startsWith

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean startsWith​(java.lang.String srcStr,
                                 int sPos,
                                 int ePos,
                                 java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' starts with 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') starts with 'compareStr'
        Code:
        Exact Method Body:
         return CmprSW.sw(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • startsWithIgnoreCase

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean startsWithIgnoreCase​(java.lang.String srcStr,
                                           int sPos,
                                           int ePos,
                                           java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' starts with 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') starts with 'compareStr'
        Code:
        Exact Method Body:
         return CmprSW.sw_CI(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • endsWith

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean endsWith​(java.lang.String srcStr,
                               int sPos,
                               int ePos,
                               java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' ends with 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') ends with 'compareStr'
        Code:
        Exact Method Body:
         return CmprEW.ew(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • endsWithIgnoreCase

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean endsWithIgnoreCase​(java.lang.String srcStr,
                                         int sPos,
                                         int ePos,
                                         java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' ends with 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') ends with 'compareStr'
        Code:
        Exact Method Body:
         return CmprEW.ew_CI(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • contains

        🡅  🡇  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean contains​(java.lang.String srcStr,
                               int sPos,
                               int ePos,
                               java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' contains 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains 'compareStr'
        Code:
        Exact Method Body:
         return CmprCN.contains(srcStr, new LV(srcStr, sPos, ePos), compareStr);

      • containsIgnoreCase

        🡅  ⇈  ⮫     External-Java:   ⮫ 🗕  🗗  🗖 
        public static boolean containsIgnoreCase​(java.lang.String srcStr,
                                         int sPos,
                                         int ePos,
                                         java.lang.String compareStr)
        Checks whether or not a substring of 'srcStr' contains 'compareStr'. The substring that is checked is demarcated by 'sPos' (inclusive), and 'ePos' (exclusive).

        The test performed here ** is not ** case-sensitive.
        Parameters:
        srcStr - Any non-null instance of a java.lang.String
        compareStr - The String used in the comparison against 'srcStr'
        Returns:
        This will return TRUE if and only if the specified substring between 'sPos' and 'ePos' (extraced from 'srcStr') contains 'compareStr'
        Code:
        Exact Method Body:
         return CmprCN.containsIgnoreCase(srcStr, new LV(srcStr, sPos, ePos), compareStr);