-- import "github.com/kokizzu/gotro/S"
const MaxStrLenCB63 = 11const WebBR = "\n<br/>"var ModCB63 []uint64func AsF(str string) (float64, bool)AsF convert to float64 with check
S.AsF(`1234.5`) // 1234.5, true
S.AsF(`1abc`) // 0.0, false
func AsI(str string) (int64, bool)AsI convert to int64 with check
S.AsI(`1234`) // 1234, true
S.AsI(`1abc`) // 0, false
func AsU(str string) (uint, bool)AsU convert to uint with check
S.AsU(`1234`) // 1234, true
S.AsU(`1abc`) // 0, false
func BT(str string) stringBT add backtick quote in the beginning and the end of string, without escaping.
S.Q(`coba`) // "`coba`"
S.Q(`123`) // "`123`"
func CamelCase(s string) stringCamelCase convert to camelCase
func CharAt(str string, index int) stringCharAt get character at specific index, utf-8 safe
S.CharAt(`Halo 世界`, 5) // `世` // utf-8 example, if characters not shown, it's probably your font/editor/plugin
S.CharAt(`Halo`, 3) // `o`
func CheckPassword(hash string, rawPassword string) errorCheckPassword check encrypted password
func Coalesce(strs ...string) stringCoalesce coalesce, return first non-empty string
S.Coalesce(`1`,`2`) // `1`
S.Coalesce(``,`2`) // `2`
S.Coalesce(``,``,`3`) // `3`
func ConcatIfNotEmpty(str, sep string) stringConcatIfNotEmpty concat if not empty with additional separator
func Contains(str, substr string) boolContains check whether the input string (first arg) contains a certain sub string (second arg) or not.
S.Contains(`komputer`,`om`)) // bool(true)
S.Contains(`komputer`,`opu`)) // bool(false)
func Count(str, substr string) intCount count how many specific character (first arg) that the string (second arg) contains
S.Count(`komputeer`,`e`))// output int(2)
func DecodeCB63(str string) (int64, bool)DecodeCB63 convert custom base-63 encoding to int64
S.DecodeCB63(`--0`) // 1, true
S.DecodeCB64(`(*&#$`) // 0, false
func EncodeCB63(id int64, min_len int) stringEncodeCB63 convert integer to custom base-63 encoding that lexicographically correct, positive integer only
0 -
1..10 0..9
11..36 A..Z
37 _
38..63 a..z
S.EncodeCB63(11,1) // `A`
S.EncodeCB63(1,3) // `--0`
func EncryptPassword(s string) stringEncryptPassword hash password (with salt)
func EndsWith(str, suffix string) boolEndsWith check whether the input string (first arg) ends with a certain character (second arg) or not.
S.EndsWith(`adakah`,`ah`)) // bool(true)
S.EndsWith(`adakah`,`aka`)) // bool(false)
func Equals(strFirst, strSecond string) boolEquals compare two input string (first arg) equal with another input string (second arg).
S.Equals(`komputer`,`komputer`)) // bool(true)
S.Equals(`komputer`,`Komputer`)) // bool(false)
func EqualsIgnoreCase(strFirst, strSecond string) boolEqualsIgnoreCase compare two input string (first arg) equal with ignoring case another input string (second arg).
S.EqualsIgnoreCase(`komputer`,`komputer`)) // bool(true)
S.EqualsIgnoreCase(`komputer`,`Komputer`)) // bool(true)
func FirstIsLower(s string) boolFirstIsLower check first character is lowercase
func HashPassword(pass string) stringHashPassword hash password with sha256 (without salt)
func If(b bool, yes string) stringIf simplified ternary operator (bool ? val : 0), returns second argument, if the condition (first arg) is true, returns empty string if not
S.If(true,`a`) // `a`
S.If(false,`a`) // ``
func IfElse(b bool, yes, no string) stringIfElse ternary operator (bool ? val1 : val2), returns second argument if the condition (first arg) is true, third argument if not
S.IfElse(true,`a`,`b`) // `a`
S.IfElse(false,`a`,`b`) // `b`
func IfEmpty(str1, str2 string) stringIfEmpty coalesce, return first non-empty string
S.IfEmpty(``,`2`) // `2`
S.IfEmpty(`1`,`2`) // `1`
func IndexOf(str, sub string) intIndexOf get first index of S.IndexOf(abcdcd,`c) // 2, -1 if not exists
func JsonAsArr(str string) (res []any, ok bool)JsonAsArr convert JSON object to []any with check
jsonStr := `[1,2,['test'],'a']`
arr, ok := S.JsonAsArr(jsonStr)
func JsonAsFloatArr(str string) (res []float64, ok bool)JsonAsFloatArr convert JSON object to []float64 with check
jsonStr := `[1,2,3]`
arr, ok := S.JsonAsFloatArr(jsonStr)
func JsonAsIntArr(str string) (res []int64, ok bool)JsonAsIntArr convert JSON object to []int64 with check
jsonStr := `[1,2,3]`
arr, ok := S.JsonAsIntArr(jsonStr)
func JsonAsMap(str string) (res map[string]any, ok bool)JsonAsMap convert JSON object to map[string]any with check
jsonStr := `{"test":123,"bla":[1,2,3,4]}`
map1, ok := S.JsonAsMap(jsonStr)
func JsonAsStrArr(str string) (res []string, ok bool)JsonAsStrArr convert JSON object to []string with check
jsonStr := `["a","b","c"]`
arr, ok := S.JsonAsStrArr(jsonStr)
func JsonToArr(str string) (res []any)JsonToArr convert JSON object to []any, silently print and return empty slice of interface if failed
jsonStr := `[1,2,['test'],'a']`
arr := S.JsonToArr(jsonStr)
func JsonToIntArr(str string) (res []int64)JsonToIntArr convert JSON object to []int64, silently print and return empty slice of interface if failed
jsonStr := `[1,2,['test'],'a']`
arr := S.JsonToArr(jsonStr)
func JsonToMap(str string) (res map[string]any)JsonToMap convert JSON object to map[string]any, silently print and return empty map if failed
jsonStr := `{"test":123,"bla":[1,2,3,4]}`
map1 := S.JsonToMap(jsonStr)
func JsonToObjArr(str string) (res []map[string]any)JsonToObjArr convert JSON object to []map[string]any, silently print and return empty slice of interface if failed
jsonStr := `[{"x":"foo"},{"y":"bar"}]`
arr := S.JsonToObjArr(jsonStr)
func JsonToStrArr(str string) (res []string)JsonToStrArr convert JSON object to []string, silently print and return empty slice of interface if failed
jsonStr := `["123","456",789]`
arr := S.JsonToStrArr(jsonStr)
func JsonToStrStrMap(str string) (res map[string]string)JsonToStrStrMap convert JSON object to map[string]string, silently print and return empty map if failed
jsonStr := `{"test":123,"bla":[1,2,3,4]}`
map1 := S.JsonToMap(jsonStr)
func LastIndexOf(str, sub string) intLastIndexOf get last index of
S.LastIndexOf(`abcdcd`,`c`) // 4, -1 if not exists
func Left(str string, n int) stringLeft substring at most n characters
func LeftN(str string, n int) stringLeftN substring at most n characters
func LeftOf(str, substr string) stringLeftOf substring before first substr
func LeftOfLast(str, substr string) stringLeftOfLast substring before last substr
func LowerFirst(s string) stringLowerFirst convert to lower only first char
func MergeMailContactEmails(each_name, str_emails string) []stringMergeMailContactEmails return formatted array of mail contact usr@email
func Mid(str string, left int, length int) stringMid substring at set left right n characters
func PadLeft(s string, padStr string, lenStr int) stringPadLeft append padStr to left until length is lenStr
func PadRight(s string, padStr string, lenStr int) stringPadRight append padStr to right until length is lenStr
func PascalCase(s string) stringPascalCase convert to PascalCase source: https://github.com/iancoleman/strcase
func Q(str string) stringQ add single quote in the beginning and the end of string, without escaping.
S.Q(`coba`) // `'coba'`
S.Q(`123`) // `'123'`
func QQ(str string) stringQQ add double quote in the beginning and the end of string, without escaping.
S.Q(`coba`) // `"coba"`
S.Q(`123`) // `"123"`
func RandomCB63(len int64) stringRandomCB63 random CB63 n-times, the result is n*MaxStrLenCB63 bytes
func RandomPassword(strlen int64) stringRandomPassword create a random password
func RemoveCharAt(str string, index int) stringRemoveCharAt remove character at specific index, utf-8 safe
S.RemoveCharAt(`Halo 世界`, 5) // `Halo 界` --> utf-8 example, if characters not shown, it's probably your font/editor/plugin
S.RemoveCharAt(`Halo`, 3) // `Hal`
func RemoveLastN(str string, n int) stringRemoveLastN remove last n character, not UTF-8 friendly
func Repeat(str string, count int) stringrepeat string
func Replace(haystack, needle, gold string) stringReplace replace all substring with another substring
S.Replace(`bisa`,`is`,`us`) // `busa`
func Right(str string, n int) stringRight substring at right most n characters
func RightOf(str, substr string) stringRightOf substring after first substr
func RightOfLast(str, substr string) stringRightOfLast substring after last substr
func SnakeCase(s string) stringSnakeCase convert to snake case source: https://github.com/iancoleman/strcase
func Split(str, sep string) []stringSplit split a string (first arg) by characters (second arg) into array of strings (output).
S.Split(`biiiissssa`,func(ch rune) bool { return ch == `i` }) // output []string{"b", "", "", "", "ssssa"}
func SplitFunc(str string, fun func(rune) bool) []stringSplitFunc split a string (first arg) based on a function
func SplitN(str string, n int) []stringSplitN split to substrings with maximum n characters
func StartsWith(str, prefix string) boolStartsWith check whether the input string (first arg) starts with a certain character (second arg) or not.
S.StartsWith(`adakah`,`ad`) // bool(true)
S.StartsWith(`adakah`,`bad`) // bool(false)
func ToF(str string) float64ToF convert string to float64, returns 0 and silently print error if not valid
S.ToF(`1234.5`) // 1234.5
S.ToF(`1a`) // 0.0
func ToI(str string) int64ToI convert string to int64, returns 0 and silently print error if not valid
S.ToI(`1234`) // 1234
S.ToI(`1a`) // 0
func ToInt(str string) intToInt convert string to int, returns 0 and silently print error if not valid
S.ToInt(`1234`) // 1234
S.ToInt(`1a`) // 0
func ToLower(str string) stringToLower change the characters in string to lowercase
S.ToLower(`BIsa`) // "bisa"
func ToTitle(str string) stringToTitle Change first letter for every word to uppercase
S.ToTitle(`Disa dasi`)) // output "Disa Dasi"
func ToU(str string) uint64ToU convert string to uint64, returns 0 and silently print error if not valid
S.ToU(`1234`) // 1234
S.ToU(`1a`) // 0
func ToUpper(str string) stringToUpper change the characters in string to uppercase S.ToUpper(bisa) // "BISA"
func Trim(str string) stringTrim erase spaces from left and right
S.Trim(` withtrim: `) // `withtrim:`
func TrimChars(str, chars string) stringTrimChars remove chars from beginning and end
S.TrimChars(`aoaaffoa`,`ao`) // `ff`
func UZ(str string) stringUZ replace <, >, and & back, quot and apos to alternative utf8
func UZRAW(str string) stringUZRAW replace <, >, and & back, quot and apos to real html
func UpperFirst(s string) stringUpperFirst convert to lower only first char
func ValidateEmail(str string) stringValidateEmail return empty string if str is not a valid email
func ValidateFilename(str string) stringValidateFilename validate file name
func ValidateMailContact(str string) stringValidateMailContact return valid version of mail contact (part before usr@email)
func ValidatePhone(str string) stringValidatePhone remove invalid characters of a phone number
func XSS(str string) stringXSS replace <, >, ', ", % but without giving single quote
func XXH3(s string) uint64XXH3 fastest 64-bit hash function https://github.com/jacobmarble/go-checksum-benchmark https://github.com/Cyan4973/xxHash
func Z(str string) stringZ trim, replace <, >, ', " and gives single quote
S.Z(`<>'"`) // `<>'"
func ZB(b bool) stringZB give ' to boolean value
S.ZB(true) // `'true'`
S.ZB(false) // `'false'`
func ZI(num int64) stringZI give ' to int64 value
S.ZI(23)) // '23'
S.ZI(03)) // '3'
func ZJ(str string) stringZJ single quote a json string
hai := `{'test':123,"bla":[1,2,3,4]}`
S.ZJ(hai) // "{'test':123,\"bla\":[1,2,3,4]}"
func ZJJ(str string) stringZJJ double quote a json string
hai := `{'test':123,"bla":[1,2,3,4]}`
S.ZJJ(hai) // "{'test':123,\"bla\":[1,2,3,4]}"
func ZJLIKE(str string) stringZJLIKE ZLIKE but for json (not replacing double quote)
func ZLIKE(str string) stringZLIKE replace <, >, ', ", % and gives single quote and %
S.ZLIKE(`coba<`)) // output '%coba<%'
S.ZLIKE(`"coba"`)) // output '%"coba"%'
func ZS(str string) stringZS replace <, >, ', " and gives single quote (without trimming)
S.Z(`<>'"`) // `<>'"
func ZT(strs ...string) stringZT trace function, location of the caller code, replacement for ZC
func ZT2() stringZT2 trace function, location of 2nd level caller, parameterless, with newline
func ZU(num uint64) stringZU give ' to uint value
S.ZI(23)) // '23'
S.ZI(03)) // '3'
func ZZ(str string) stringZZ replace ` and give double quote (for table names)
S.ZZ(`coba"`) // `"coba""`