case-insensitive-0.4.0.3: Case insensitive string comparison

MaintainerBas van Dijk <v.dijk.bas@gmail.com>
Safe HaskellTrustworthy

Data.CaseInsensitive

Description

This module is intended to be imported qualified. May I suggest:

 import           Data.CaseInsensitive  ( CI )
 import qualified Data.CaseInsensitive as CI

Synopsis

Documentation

data CI s Source

A CI s provides Case Insensitive comparison for the string-like type s (for example: String, Text, ByteString, ShowS, etc.).

Note that CI s has an instance for IsString which together with the OverloadedStrings language extension allows you to write case insensitive string literals as in:

> ("Content-Type" :: CI Text) == ("CONTENT-TYPE" :: CI Text)
True

Instances

Typeable1 CI 
Eq s => Eq (CI s) 
Ord s => Ord (CI s) 
(Read s, FoldCase s) => Read (CI s) 
Show s => Show (CI s) 
(IsString s, FoldCase s) => IsString (CI s) 
Monoid s => Monoid (CI s) 
Hashable s => Hashable (CI s) 
FoldCase (CI s) 

mk :: FoldCase s => s -> CI sSource

Make the given string-like value case insensitive.

original :: CI s -> sSource

Retrieve the original string-like value.

foldedCase :: CI s -> sSource

Retrieve the case folded string-like value. (Also see foldCase).

map :: FoldCase s2 => (s1 -> s2) -> CI s1 -> CI s2Source

Transform the original string-like value but keep it case insensitive.

class FoldCase s whereSource

Class of string-like types that support folding cases.

Note: In some languages, case conversion is a locale- and context-dependent operation. The foldCase method is not intended to be locale sensitive. Programs that require locale sensitivity should use appropriate versions of the case mapping functions from the text-icu package: http://hackage.haskell.org/package/text-icu

Methods

foldCase :: s -> sSource

Instances

FoldCase String 
FoldCase ShowS 
FoldCase ByteString

Note that foldCase = map toLower which is only guaranteed to be correct for ASCII encoded strings!

FoldCase ByteString

Note that foldCase = map toLower which is only guaranteed to be correct for ASCII encoded strings!

FoldCase Text 
FoldCase Text 
FoldCase (CI s)