Moduletext-short-0.1.6Haskell2010

Data.Text.Short.Partial

Partial functions vocabulary

This module provides common partial functions for operating on ShortText.

The use of these functions is discouraged as they tend to be error-prone.

valuehead :: ShortText -> Char

\mathcal{O}(1) Returns first character of a non-empty ShortText

Example1 expression

>>> head "abcd"'a'

Note: Will throw an error exception for empty ShortTexts. Consider using the total functions uncons or indexMaybe instead.

valuetail :: ShortText -> ShortText

\mathcal{O}(n) Drop first character from non-empty ShortText.

Example1 expression

>>> tail "abcd""bcd"

Note: Will throw an error exception for empty ShortTexts. Consider using the total functions uncons or drop instead.

valueinit :: ShortText -> ShortText

\mathcal{O}(n) Drop last character from non-empty ShortText.

Example1 expression

>>> tail "abcd""bcd"

Note: Will throw an error exception for empty ShortTexts. Consider using the total functions unsnoc or dropEnd instead.

valuelast :: ShortText -> Char

\mathcal{O}(1) Return last character from non-empty ShortText.

Example1 expression

>>> last "abcd"'d'

Note: Will throw an error exception for empty ShortTexts. Consider using the total functions unsnoc or indexEndMaybe instead.

valueindex :: ShortText -> Int -> Char

\mathcal{O}(n) Retrieve i-th character (code-point)

Example1 expression

>>> index "abcd" 1'b'

Note: Will throw an error exception if index is out of bounds. Consider using the total functions indexMaybe or indexEndMaybe instead.

valuefoldl1 :: (Char -> Char -> Char) -> ShortText -> Char

\mathcal{O}(n) Reduces the characters of the ShortText with the binary operator.

Example1 expression

>>> foldl1 max "abcdcba"'d'

Example1 expression

>>> foldl1 const "abcd"'a'

Example1 expression

>>> foldl1 (flip const) "abcd"'d'

Note: Will throw an error exception if index is out of bounds.

valuefoldl1' :: (Char -> Char -> Char) -> ShortText -> Char

\mathcal{O}(n) Strict version of foldl1.

valuefoldr1 :: (Char -> Char -> Char) -> ShortText -> Char

\mathcal{O}(n) Reduces the characters of the ShortText with the binary operator.

Example1 expression

>>> foldr1 max "abcdcba"'d'

Example1 expression

>>> foldr1 const "abcd"'a'

Example1 expression

>>> foldr1 (flip const) "abcd"'d'

Note: Will throw an error exception if index is out of bounds.