API Overview
Functions
ends-with ( $string, $substring [, $end-at] )
Determines whether a string ends with the characters of a specified substring, returning true or false as appropriate.
from ( $value )
Creates a normalized string from the provided value, with unique punctuation differentiating types and characteristics.
includes ( $string, $substring [, $start-at] )
Determines whether a string includes the characters of a specified substring, returning true or false as appropriate.
index ( $string, $substring [, $start-at] )
Returns the first index at which a specified substring can be found in a string; otherwise, 0 is returned, indicating the substring is not present.
is-quoted ( $string )
Determines whether a string is quoted, returning true or false as appropriate.
last-index ( $string, $substring [, $end-at] )
Returns the last index at which a specified substring can be found in a string; otherwise, 0 is returned, indicating the substring is not present. The string is searched forwards, ending at a given index when specified.
repeat ( $string, $count )
Returns a string which contains the specified number of copies of the source string, concatenated together.
replace-all ( $string, $substring, $replacement )
Replaces all instances of a specified substring from the source string with a given replacement.
split ( $string [, $delimiter] [, $limit] [, $separator] [, $bracketed] )
Divides a string into a list of substrings.
starts-with ( $string, $substring [, $start-at] )
Determines whether a string begins with the characters of a specified substring, returning true or false as appropriate.
trim ( $string )
Removes whitespace from both ends of a string. Whitespace in this context is all the whitespace characters (space, tab, no-break space, etc.) and all the line terminator characters (LF, CR, etc.).
trim-end ( $string )
Removes whitespace from the end of a string.
trim-start ( $string )
Removes whitespace from the beginning of a string.
Don’t see the function you’re looking for? Request a new feature describing a use case.
Combined API
In order to avoid constantly declaring both the native sass:string
module and this library, the combined API has been added which merges the two.
// Rather than using both modules separately...
@use '@sass-fairy/string';
@use 'sass:string';
// ...this statement will accomplish the same thing.
@use '@sass-fairy/string/string';
Since its functionality is enhanced by this library, the combined API hides the native string.index()
function.