API: String
trim
JavaScriptDart
Removes all whitespace before and after a string. Unlike JavaScript's trim
function, it converts two or more spaces between sentences into a single space.
Parameters
str::string
Returns
string
Examples
trim(' Hello Wor ld '); // Returns 'Hello Wor ld'
trim('H e l l o World'); // Returns 'H e l l o World'
removeSpecialChar
JavaScriptDart
Returns after removing all special characters, including spaces. If you want to allow any special characters as exceptions, list them in the second argument value without delimiters. For example, if you want to allow spaces and the symbols &
and *
, the second argument value would be ' &*'.
Parameters
str::string
exceptionCharacters::string?
Dart:Named
Returns
string
Examples
removeSpecialChar('Hello-qsu, World!'); // Returns 'HelloqsuWorld'
removeSpecialChar('Hello-qsu, World!', ' -'); // Returns 'Hello-qsu World'
removeSpecialChar('Hello-qsu, World!'); // Returns 'HelloqsuWorld'
removeSpecialChar('Hello-qsu, World!', exceptionCharacters: ' -'); // Returns 'Hello-qsu World'
removeNewLine
JavaScriptDart
Removes \n
, \r
characters or replaces them with specified characters.
Parameters
str::string
replaceTo::string || ''
Dart:Named
Returns
string
Examples
removeNewLine('ab\ncd'); // Returns 'abcd'
removeNewLine('ab\r\ncd', '-'); // Returns 'ab-cd'
removeNewLine('ab\ncd'); // Returns 'abcd'
removeNewLine('ab\r\ncd', replaceTo: '-'); // Returns 'ab-cd'
replaceBetween
JavaScriptDart
Replaces text within a range starting and ending with a specific character in a given string with another string. For example, given the string abc<DEF>ghi
, to change <DEF>
to def
, use replaceBetween('abc<DEF>ghi', '<', '>', 'def')
. The result would be abcdefghi
.
Deletes strings in the range if replaceWith
is not specified.
Parameters
str::string
startChar::string
endChar::string
replaceWith::string || ''
Returns
string
Examples
replaceBetween('ab[c]d[e]f', '[', ']'); // Returns 'abdf'
replaceBetween('abcd:replace:', ':', ':', 'e'); // Returns 'abcde'
capitalizeFirst
JavaScriptDart
Converts the first letter of the entire string to uppercase and returns.
Parameters
str::string
Returns
string
Examples
capitalizeFirst('abcd'); // Returns 'Abcd'
capitalizeEverySentence
JavaScriptDart
Capitalize the first letter of every sentence. Typically, the .
characters to separate sentences, but this can be customized via the value of the splitChar
argument.
Parameters
str::string
splitChar::string
Dart:Named
Returns
string
Examples
capitalizeEverySentence('hello. world. hi.'); // Returns 'Hello. World. Hi.'
capitalizeEverySentence('hello!world', '!'); // Returns 'Hello!World'
capitalizeEverySentence('hello. world. hi.'); // Returns 'Hello. World. Hi.'
capitalizeEverySentence('hello!world', splitChar: '!'); // Returns 'Hello!World'
capitalizeEachWords
JavaScriptDart
Converts every word with spaces to uppercase. If the naturally argument is true, only some special cases (such as prepositions) are kept lowercase.
Parameters
str::string
natural::boolean || false
Dart:Named
Returns
string
Examples
capitalizeEachWords('abcd'); // Returns 'Abcd'
strCount
JavaScriptDart
Returns the number of times the second String argument is contained in the first String argument.
Parameters
str::string
search::string
Returns
number
Examples
strCount('abcabc', 'a'); // Returns 2
strShuffle
JavaScriptDart
Randomly shuffles the received string and returns it.
Parameters
str::string
Returns
string
Examples
strShuffle('abcdefg'); // Returns 'bgafced'
strRandom
JavaScriptDart
Returns a random String containing numbers or uppercase and lowercase letters of the given length. The default return length is 12.
Parameters
length::number
additionalCharacters::string?
Dart:Named
Returns
string
Examples
strRandom(5); // Returns 'CHy2M'
strBlindRandom
JavaScript
Replace strings at random locations with a specified number of characters (default 1) with characters (default *).
Parameters
str::string
blindLength::number
blindStr::string || '*'
Returns
string
Examples
strBlindRandom('hello', 2, '#'); // Returns '#el#o'
truncate
JavaScriptDart
Truncates a long string to a specified length, optionally appending an ellipsis after the string.
Parameters
str::string
length::number
ellipsis::string || ''
Dart:Named
Returns
string
Examples
truncate('hello', 3); // Returns 'hel'
truncate('hello', 2, '...'); // Returns 'he...'
truncate('hello', 3); // Returns 'hel'
truncate('hello', 2, ellipsis: '...'); // Returns 'he...'
truncateExpect
JavaScriptDart
The string ignores truncation until the ending character (endStringChar
). If the expected length is reached, return the truncated string until after the ending character.
Parameters
str::string
expectLength::number
endStringChar::string || '.'
Dart:Named
Returns
string
Examples
truncateExpect('hello. this is test string.', 10, '.'); // Returns 'hello. this is test string.'
truncateExpect('hello-this-is-test-string-bye', 14, '-'); // Returns 'hello-this-is-'
split
JavaScript
Splits a string based on the specified character and returns it as an Array. Unlike the existing split, it splits the values provided as multiple parameters (array or multiple arguments) at once.
Parameters
str::string
splitter::string||string[]||...string
Returns
string[]
Examples
split('hello% js world', '% '); // Returns ['hello', 'js world']
split('hello,js,world', ','); // Returns ['hello', 'js', 'world']
split('hello%js,world', ',', '%'); // Returns ['hello', 'js', 'world']
split('hello%js,world', [',', '%']); // Returns ['hello', 'js', 'world']
strUnique
JavaScriptDart
Remove duplicate characters from a given string and output only one.
Parameters
str::string
Returns
string
Examples
strUnique('aaabbbcc'); // Returns 'abc'
strToAscii
JavaScriptDart
Converts the given string to ascii code and returns it as an array.
Parameters
str::string
Returns
number[]
Examples
strToAscii('12345'); // Returns [49, 50, 51, 52, 53]
urlJoin
JavaScriptDart
Merges the given string argument with the first argument (the beginning of the URL), joining it so that the slash (/
) symbol is correctly included.
In Dart, accepts only one argument, organized as an List.
Parameters
args::...any[]
(JavaScript)args::List<dynamic>
(Dart)
Returns
string
Examples
urlJoin('https://example.com', 'hello', 'world'); // Returns 'https://example.com/hello/world'
urlJoin(['https://example.com', 'hello', 'world']); // Returns 'https://example.com/hello/world'