StringExt

func AdvancedFieldsSplitter ¶ added in v0.2.33

func AdvancedFieldsSplitter(sentence string, indentLevel int) ([][]string, error)

SplitSentenceIntoFields splits the string into fields, where each field is a substring separated by one or more whitespace characters. The function also handles special characters such as tabs, vertical tabs, carriage returns, line feeds, and form feeds.

Parameters:

• sentence: The string to split into fields.
• indentLevel: The number of spaces that a tab character is replaced with.

Returns:

• [][]string: A two-dimensional slice of strings, where each inner slice represents the fields of a line from the input string.
• error: An error of type *ers.ErrInvalidRuneAt if an invalid rune is found in the sentence.

Notes:

• Negative indentLevel values are converted to positive values.
• Empty sentences return an empty slice with no errors.

func ByteSplitter ¶ added in v0.2.28

func ByteSplitter(data []byte, sep byte) [][]byte

ByteSplitter splits a byte slice into multiple slices based on a separator byte. The separator byte is not included in the resulting slices.

If the input slice is empty, the function returns nil.

Parameters:

• data: The byte slice to split.
• sep: The separator byte.

Returns:

• [][]byte: A slice of byte slices.

func FindContentIndexes ¶

func FindContentIndexes(openingToken, closingToken string, contentTokens []string) (int, int, error)

FindContentIndexes searches for the positions of opening and closing tokens in a slice of strings.

Parameters:

• openingToken: The string that marks the beginning of the content.
• closingToken: The string that marks the end of the content.
• contentTokens: The slice of strings in which to search for the tokens.

Returns:

• int: The start index of the content (inclusive).
• int: The end index of the content (exclusive).
• error: Any error that occurred while searching for the tokens.

Errors:

• *ers.ErrInvalidParameter: If the openingToken or closingToken is an empty string.
• *ErrTokenNotFound: If the opening or closing token is not found in the content.
• *ErrNeverOpened: If the closing token is found without any corresponding opening token.

func GenerateID ¶ added in v0.2.14

func GenerateID(size int) (string, error)

GenerateID generates a random ID of the specified size (in bytes).

The function uses the crypto/rand package to generate a random ID of the specified size.

Errors:

• *ers.ErrInvalidParameter: If the size is less than 1.
• Any error returned by the rand.Read function.

Parameters:

• size: The size of the ID to generate (in bytes).

Returns:

• string: The generated ID.
• error: An error if the ID cannot be generated.

func JoinBytes ¶ added in v0.2.28

func JoinBytes(slices [][]byte, sep byte) string

JoinBytes joins multiple byte slices into a single string using a separator byte.

If the input slice is empty, the function returns an empty string.

Parameters:

• slices: A slice of byte slices to join.
• sep: The separator byte.

Returns:

• string: The joined string.

func ReplaceSuffix ¶

func ReplaceSuffix(str, suffix string) (string, error)

ReplaceSuffix replaces the end of the given string with the provided suffix.

Parameters:

• str: The original string.
• suffix: The suffix to replace the end of the string.

Returns:

• string: The resulting string after replacing the end with the suffix.
• error: An error of type *ErrLongerSuffix if the suffix is longer than the string.

Examples:

const (
	str    string = "hello world"
	suffix string = "Bob"
)

result, err := ReplaceSuffix(str, suffix)

if err != nil {
	fmt.Println(err)
} else {
	fmt.Println(result) // Output: hello woBob
}

func ToUTF8Runes ¶ added in v0.2.33

func ToUTF8Runes(s string) ([]rune, error)

ToUTF8Runes converts a string to a slice of runes.

Parameters:

• s: The string to convert.

Returns:

• []rune: The slice of runes
• error: An error of type *ErrAtIndex if the string contains invalid UTF-8 encoding.