Uniform.Strings

a top module exporting the operations in the package

Documentation

module Uniform.Strings.Conversion

module Uniform.Strings.Utilities

(<:>) :: Text -> Text -> Text

append text with colon in between

(<+>) :: Text -> Text -> Text

(<->) :: Text -> Text -> Text

append text with dash in between

(<#>) :: Text -> Text -> Text

(<|>) :: Text -> Text -> Text

append text with blank in between, (a character does not work as name) possible conflict with parsec

wrapInSpitz :: Text -> Text

insert text in ..

wrapInDoubleQuotes :: Text -> Text

insert text in ..

wrapInBraces :: Text -> Text

insert text in ..

addXatEnd :: (IsString s, CharChains s) => s -> s -> s

class IsString a where

Class for string-like datastructures; used by the overloaded string extension (-XOverloadedStrings in GHC).

Methods

fromString :: String -> a

Instances

IsString ByteString

Beware: fromString truncates multi-byte characters to octets. e.g. "枯朶に烏のとまりけり秋の暮" becomes �6k�nh~�Q��n�

Defined in Data.ByteString.Internal

Methods

fromString :: String -> ByteString

IsString ByteString

Beware: fromString truncates multi-byte characters to octets. e.g. "枯朶に烏のとまりけり秋の暮" becomes �6k�nh~�Q��n�

Defined in Data.ByteString.Lazy.Internal

Methods

fromString :: String -> ByteString

IsString ShortByteString

Beware: fromString truncates multi-byte characters to octets. e.g. "枯朶に烏のとまりけり秋の暮" becomes �6k�nh~�Q��n�

Defined in Data.ByteString.Short.Internal

Methods

fromString :: String -> ShortByteString

IsString Doc

Defined in Text.PrettyPrint.HughesPJ

Methods

fromString :: String -> Doc

IsString a => IsString (Identity a)

Since: base-4.9.0.0

Defined in Data.String

Methods

fromString :: String -> Identity a

a ~ Char => IsString (Seq a)

Since: containers-0.5.7

Defined in Data.Sequence.Internal

Methods

fromString :: String -> Seq a

(IsString a, Hashable a) => IsString (Hashed a)

Defined in Data.Hashable.Class

Methods

fromString :: String -> Hashed a

IsString (Doc a)

Defined in Text.PrettyPrint.Annotated.HughesPJ

Methods

fromString :: String -> Doc a

a ~ Char => IsString [a]

(a ~ Char) context was introduced in 4.9.0.0

Since: base-2.1

Defined in Data.String

Methods

fromString :: String -> [a]

IsString a => IsString (Const a b)

Since: base-4.9.0.0

Defined in Data.String

Methods

fromString :: String -> Const a b

type String = [Char]

A String is a list of characters. String constants in Haskell are values of type String.

See Data.List for operations on lists.

unlines :: [String] -> String

unlines is an inverse operation to lines. It joins lines, after appending a terminating newline to each.

>>> unlines ["Hello", "World", "!"]
"Hello\nWorld\n!\n"

lines :: String -> [String]

lines breaks a string up into a list of strings at newline characters. The resulting strings do not contain newlines.

Note that after splitting the string at newline characters, the last part of the string is considered a line even if it doesn't end with a newline. For example,

>>> lines ""
[]

>>> lines "\n"
[""]

>>> lines "one"
["one"]

>>> lines "one\n"
["one"]

>>> lines "one\n\n"
["one",""]

>>> lines "one\ntwo"
["one","two"]

>>> lines "one\ntwo\n"
["one","two"]

Thus lines s contains at least as many elements as newlines in s.

words :: String -> [String]

words breaks a string up into a list of words, which were delimited by white space.

>>> words "Lorem ipsum\ndolor"
["Lorem","ipsum","dolor"]

unwords :: [String] -> String

unwords is an inverse operation to words. It joins words with separating spaces.

>>> unwords ["Lorem", "ipsum", "dolor"]
"Lorem ipsum dolor"

putIOwords :: MonadIO m => [Text] -> m ()

class Show a => NiceStrings a where

Minimal complete definition

showNice

Methods

shownice :: a -> Text

showNice :: a -> Text

showlong :: a -> Text

Instances

NiceStrings Text

Defined in Uniform.Strings.Utilities

Methods

shownice :: Text -> Text

showNice :: Text -> Text

showlong :: Text -> Text

NiceStrings Double

Defined in Uniform.Strings.Utilities

Methods

shownice :: Double -> Text

showNice :: Double -> Text

showlong :: Double -> Text

NiceStrings Float

Defined in Uniform.Strings.Utilities

Methods

shownice :: Float -> Text

showNice :: Float -> Text

showlong :: Float -> Text

NiceStrings Int

Defined in Uniform.Strings.Utilities

Methods

shownice :: Int -> Text

showNice :: Int -> Text

showlong :: Int -> Text

NiceStrings a => NiceStrings (Maybe a)

Defined in Uniform.Strings.Utilities

Methods

shownice :: Maybe a -> Text

showNice :: Maybe a -> Text

showlong :: Maybe a -> Text

(Show a, NiceStrings a) => NiceStrings [a]

Defined in Uniform.Strings.Utilities

Methods

shownice :: [a] -> Text

showNice :: [a] -> Text

showlong :: [a] -> Text

(NiceStrings a, NiceStrings b) => NiceStrings (a, b)

Defined in Uniform.Strings.Utilities

Methods

shownice :: (a, b) -> Text

showNice :: (a, b) -> Text

showlong :: (a, b) -> Text

(Show a, Show b, Show c) => NiceStrings (a, b, c)

Defined in Uniform.Strings.Utilities

Methods

shownice :: (a, b, c) -> Text

showNice :: (a, b, c) -> Text

showlong :: (a, b, c) -> Text

class IsString a where

Class for string-like datastructures; used by the overloaded string extension (-XOverloadedStrings in GHC).

Methods

fromString :: String -> a

Instances

IsString ByteString

Beware: fromString truncates multi-byte characters to octets. e.g. "枯朶に烏のとまりけり秋の暮" becomes �6k�nh~�Q��n�

Defined in Data.ByteString.Internal

Methods

fromString :: String -> ByteString

IsString ByteString

Beware: fromString truncates multi-byte characters to octets. e.g. "枯朶に烏のとまりけり秋の暮" becomes �6k�nh~�Q��n�

Defined in Data.ByteString.Lazy.Internal

Methods

fromString :: String -> ByteString

IsString ShortByteString

Beware: fromString truncates multi-byte characters to octets. e.g. "枯朶に烏のとまりけり秋の暮" becomes �6k�nh~�Q��n�

Defined in Data.ByteString.Short.Internal

Methods

fromString :: String -> ShortByteString

IsString Doc

Defined in Text.PrettyPrint.HughesPJ

Methods

fromString :: String -> Doc

IsString a => IsString (Identity a)

Since: base-4.9.0.0

Defined in Data.String

Methods

fromString :: String -> Identity a

a ~ Char => IsString (Seq a)

Since: containers-0.5.7

Defined in Data.Sequence.Internal

Methods

fromString :: String -> Seq a

(IsString a, Hashable a) => IsString (Hashed a)

Defined in Data.Hashable.Class

Methods

fromString :: String -> Hashed a

IsString (Doc a)

Defined in Text.PrettyPrint.Annotated.HughesPJ

Methods

fromString :: String -> Doc a

a ~ Char => IsString [a]

(a ~ Char) context was introduced in 4.9.0.0

Since: base-2.1

Defined in Data.String

Methods

fromString :: String -> [a]

IsString a => IsString (Const a b)

Since: base-4.9.0.0

Defined in Data.String

Methods

fromString :: String -> Const a b

type family LF l

Instances

type LF Text

Defined in Uniform.Strings.Utilities

type LF Text = Char

type LF BSUTF

Defined in Uniform.Strings.Utilities

type LF BSUTF = Char

type LF LazyByteString

Defined in Uniform.Strings.Utilities

type LF LazyByteString = Char

type LF String

Defined in Uniform.Strings.Utilities

type LF String = Char

class (Monoid l, Zeros (LF l)) => ListForms l where

Minimal complete definition

mkOne

Associated Types

type LF l

Methods

prependOne :: LF l -> l -> l

appendOne :: l -> LF l -> l

mkOne :: LF l -> l

appendTwo :: l -> l -> l

Instances

ListForms Text

Defined in Uniform.Strings.Utilities

Associated Types

type LF Text

Methods

prependOne :: LF Text -> Text -> Text

appendOne :: Text -> LF Text -> Text

mkOne :: LF Text -> Text

appendTwo :: Text -> Text -> Text

ListForms BSUTF

Defined in Uniform.Strings.Utilities

Associated Types

type LF BSUTF

Methods

prependOne :: LF BSUTF -> BSUTF -> BSUTF

appendOne :: BSUTF -> LF BSUTF -> BSUTF

mkOne :: LF BSUTF -> BSUTF

appendTwo :: BSUTF -> BSUTF -> BSUTF

ListForms LazyByteString

Defined in Uniform.Strings.Utilities

Associated Types

type LF LazyByteString

Methods

prependOne :: LF LazyByteString -> LazyByteString -> LazyByteString

appendOne :: LazyByteString -> LF LazyByteString -> LazyByteString

mkOne :: LF LazyByteString -> LazyByteString

appendTwo :: LazyByteString -> LazyByteString -> LazyByteString

ListForms String

Defined in Uniform.Strings.Utilities

Associated Types

type LF String

Methods

prependOne :: LF String -> String -> String

appendOne :: String -> LF String -> String

mkOne :: LF String -> String

appendTwo :: String -> String -> String

ppShowList :: (Foldable f, Show a) => f a -> String

Pretty print something that may be converted to a list as a list. Each entry is on a separate line, which means that we don't do clever pretty printing, and so this works well for large strucutures.

ppShow :: Show a => a -> String

Convert a generic value into a pretty Value, if possible.