Safe Haskell | Safe-Inferred |
---|---|
Language | Haskell2010 |
Compact representation of short Strings
This module is designed to be import qualifeid
import Distribution.Utils.ShortText (ShortText) import qualified Distribution.Utils.ShortText as ShortText
Synopsis
- data ShortText
- toShortText :: String -> ShortText
- fromShortText :: ShortText -> String
- unsafeFromUTF8BS :: ByteString -> ShortText
- null :: ShortText -> Bool
- length :: ShortText -> Int
- decodeStringUtf8 :: [Word8] -> String
- encodeStringUtf8 :: String -> [Word8]
ShortText
type
Compact representation of short Strings
The data is stored internally as UTF8 in an
ShortByteString
when compiled against bytestring >=
0.10.4
, and otherwise the fallback is to use plain old non-compat
'[Char]'.
Note: This type is for internal uses (such as e.g. PackageName
)
and shall not be exposed in Cabal's API
Since: Cabal-2.0.0.2
Instances
unsafeFromUTF8BS :: ByteString -> ShortText Source #
Convert from UTF-8 encoded strict ByteString
.
Since: Cabal-3.2.0.0
Operations
length :: ShortText -> Int Source #
O(n). Length in characters. Slow as converts to string.
Since: Cabal-3.2.0.0
internal utilities
decodeStringUtf8 :: [Word8] -> String Source #
Decode String
from UTF8-encoded octets.
Invalid data in the UTF8 stream (this includes code-points U+D800
through U+DFFF
) will be decoded as the replacement character (U+FFFD
).
See also encodeStringUtf8