[object Object]

String Functions

The string functions were implemented to handle the negative values being passed to the spacing() function, but are available to help you write your own functions and mixins.

Replace

The str-replace() function is designed to find a substring in a string a replace it with another value. The function take three parameters: the original value, the value to look for, and the value to replace it with.

Example

$prefix-color: 'dark-primary';
$color: str-replace($prefix-color, 'dark-', '');
// $color is 'primary'

$color-2: str-replace($prefix-color, 'primary', 'light');
// $color-2 is 'dark-light'

Ends With

The str-ends-with() function determines whether a string ends with the characters of a specified string and returns true if the string ends with the characters, and false if not. The function takes two parameters: the first is the string that you want validate and the second is the string to search for.

Example

$prefix-color: 'dark-primary';
$is-primary: str-ends-with($prefix-color, 'primary');
// $is-primary is true

Contains

The str-contains() function determines whether a string contains the characters of a specified string and returns true if the string contains the characters, and false if not. The function takes two parameters: the first is the string that you want validate and the second is the string to search for.

Example

$prefix-color: 'dark-primary';
$has-dash: str-contains($prefix-color, '-');
// $has-dash is true