str

Documentation

Overview

Package str provides string manipulation utilities.

Index

• func Contains(x []string, s string) bool
• func FoldDup(list []string) (string, string)
• func HasFilePathPrefix(s, prefix string) bool
• func HasPathPrefix(s, prefix string) bool
• func QuoteGlob(s string) string
• func StringList(args ...any) []string
• func ToFold(s string) string
• func TrimFilePathPrefix(s, prefix string) string
• func Uniq(ss *[]string)

Functions

func Contains

func Contains(x []string, s string) bool

Contains reports whether x contains s.

func FoldDup

func FoldDup(list []string) (string, string)

FoldDup reports a pair of strings from the list that are equal according to strings.EqualFold. It returns "", "" if there are no such strings.

func HasFilePathPrefix

func HasFilePathPrefix(s, prefix string) bool

HasFilePathPrefix reports whether the filesystem path s begins with the elements in prefix.

func HasPathPrefix

func HasPathPrefix(s, prefix string) bool

HasPathPrefix reports whether the slash-separated path s begins with the elements in prefix.

func QuoteGlob

func QuoteGlob(s string) string

QuoteGlob returns s with all Glob metacharacters quoted. We don't try to handle backslash here, as that can appear in a file path on Windows.

func StringList

func StringList(args ...any) []string

StringList flattens its arguments into a single []string. Each argument in args must have type string or []string.

func ToFold

func ToFold(s string) string

ToFold returns a string with the property that

strings.EqualFold(s, t) iff ToFold(s) == ToFold(t)

This lets us test a large set of strings for fold-equivalent duplicates without making a quadratic number of calls to EqualFold. Note that strings.ToUpper and strings.ToLower do not have the desired property in some corner cases.

func TrimFilePathPrefix

func TrimFilePathPrefix(s, prefix string) string

TrimFilePathPrefix returns s without the leading path elements in prefix. If s does not start with prefix (HasFilePathPrefix with the same arguments returns false), TrimFilePathPrefix returns s. If s equals prefix, TrimFilePathPrefix returns "".

func Uniq

func Uniq(ss *[]string)

Uniq removes consecutive duplicate strings from ss.