pro.fessional.mirana.text

Class Wildcard

java.lang.Object

pro.fessional.mirana.text.Wildcard

public class Wildcard
extends Object

 High-performance, low-fragmentation wildcard matching.
 Provides a left-to-right wildcard matching pattern, where
  - `?` means any one char
  - `*` means any number of char
  - `?*` means at least one char
  - `**` is treated as `*`
  - `*?` is treated as `?*`.
 Note that matching is by char, not by byte
 

Since:

2020-09-26

Author:

trydofor

Constructor Summary

Constructors

Constructor and Description
Wildcard()

Method Summary

Modifier and Type	Method and Description
static @NotNull String[]	compile(CharSequence str) Split into arrays by `*`.
static int	index(boolean igc, @NotNull CharSequence str, int off, @NotNull String ptn) match the index from offset at the beginning, -1 means not found.
static int	index(boolean igc, @NotNull CharSequence str, @NotNull String ptn) match the index from the beginning, -1 means not found.
static int	index(@NotNull CharSequence str, @NotNull String ptn) Case-insensitive match the index from the beginning, -1 means not found.
static boolean	match(boolean igc, CharSequence str, String... ptn) null does not match any character, but matches if all null are present.

Methods inherited from class java.lang.Object

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

Constructor Detail

Wildcard

public Wildcard()

Method Detail

compile

@NotNull
public static @NotNull String[] compile(CharSequence str)

 Split into arrays by `*`. `**` treated as `*`, `*?` treated as `?*`
 `*.doc` = [`*`,`.doc`]
 `abc?.doc` = [`abc?.doc`]
 `**.doc` = [`*`,`.doc`]
 `??*.doc` = [`??`,`*`,`.doc`]
 `**?**.doc` = [`?`,`*`,`.doc`]
 

match

public static boolean match(boolean igc,
                            CharSequence str,
                            String... ptn)

null does not match any character, but matches if all null are present.

Parameters:

igc - whether ignore case (case-insensitive)

str - string to match, skip null

ptn - patterns (should from `compile`), null or empty don't match

index

public static int index(@NotNull
                        @NotNull CharSequence str,
                        @NotNull
                        @NotNull String ptn)

Case-insensitive match the index from the beginning, -1 means not found.

See Also:

index(boolean, CharSequence, int, String)

index

public static int index(boolean igc,
                        @NotNull
                        @NotNull CharSequence str,
                        @NotNull
                        @NotNull String ptn)

match the index from the beginning, -1 means not found.

See Also:

index(boolean, CharSequence, int, String)

index

public static int index(boolean igc,
                        @NotNull
                        @NotNull CharSequence str,
                        int off,
                        @NotNull
                        @NotNull String ptn)

match the index from offset at the beginning, -1 means not found. support `?` and case-insensitive match, equal to String.indexOf

Parameters:

igc - whether ignore case (case-insensitive)

str - string to match

off - the offset to match from

ptn - the pattern to match