Want to look up value-pairs from the left or the right?

Like assoc-list, a PairDict allows for anything as left or right values except for functions and things that contain functions.

Example: cased letters

lowerUppercaseLetters=
  empty
  |>insert ( 'a', 'A' )
  |>insert ( 'b', 'B' )
  |>insert ( 'c', 'C' )


upperCase char=
  rightOf char lowerUppercaseLetters

using (==) built-in equality is often not useful in the context of association-dicts.

Ignoring insertion order: do these 2 PairDicts have the same size and identical Pairs?

letterCodes=
  fromList [ ( 'a', 0 ), ( 'b', 1 ) ]
fancyCompetingLetterCodes=
  fromList [ ( 'b', 1 ), ( 'a', 0 ) ]


equal
  letterCodes
  fancyCompetingLetterCodes
--> True

A PairDict with no elements

Create a PairDict from a association-Dict. left is the key, right is the value. If multiple equal keys or values are present, the value first in the Dict is prefered.

lowerToUpperLetters=
  AssocList.Dict.empty
  |>AssocList.Dict.insert 'a' 'A'
  |>AssocList.Dict.insert 'b' 'B'


lowerUpperLetters= fromDict lowerToUpperLetters

Create a PairDict conveniently from Tuples. left is the first, right is the second. If right or left values are given multiple times, the value first in the List is prefered.

fromList
  [ ( 'b', 'B' ) --insert ( 'b', 'B' )
  , ( 'a', 'A' ) --insert ( 'a', 'A' )
  , ( 'b', 'C' ) --ignored, as the left value already exists
  , ( 'c', 'A' ) --ignored, as the right value already exists
  , ( 'c', 'C' ) --insert ( 'c', 'C' )
  ]

A Json.Decode.Decoder for PairDicts, encoded by encodePair.

The order of insertion is not reconstructed (see equal)

"""
[
 {
  \"left\": 2,
  \"right\": 22
 },
 {
  \"left\": 1,
  \"right\": 11
 }
]
"""
|>Decode.decodeString
    (decode Decode.int Decode.int)

Ok (fromList [ ( 1, 11 ), ( 2, 22 ) ])

Just the right value if the left value is present in the PairDict, else Nothing

casedLetters=
  empty
  |>insert ( 'a', 'A' )
  |>insert ( 'b', 'B' )


lowerCase char=
  leftOf char casedLetters

Just the right value if the left value is present in the PairDict, else Nothing

casedLetters=
  empty
  |>insert ( 'a', 'A' )
  |>insert ( 'b', 'B' )


upperCase char=
  rightOf char casedLetters

How many pairs there are.

size empty

0

size
  (fromList
    (List.range 0 41 |>List.map (\i-> ( i, i )))
  )

42

Put in a left-right-Pair.

If either value is already present, the PairDict is unchanged.

empty
|>insert ( 'b', 'B' ) --puts it in 
|>insert ( 'a', 'A' ) --puts it in
|>insert ( 'b', 'C' ) --ignored, the left value already exists
|>insert ( 'c', 'A' ) --ignored, the right value already exists
|>insert ( 'c', 'C' ) --puts it in

Merge 2 PairDicts. If a value on the left or right is present, prefer the second dict.

numberNamedOperators=
  fromList
    [ ( '+', "plus" )
    , ( '-', "minus" )
    ]
customNamedOperators=
  fromList
    [ ( '∧', "and" )
    , ( '∨', "or" )
    , ( '-', "negate" )
    ]
validNamedOperators=
  union
    custumNamedOperators --has a '-' left
    numberOperatorNames --preferred → its '-'-Pair is inserted

remove left-right pair. If left does not exist, the PairDict is unchanged

empty
|>insert "(" ")"
|>removeLeft ")" --unchanged, ")" is not a left value
|>removeLeft "(" --removes ( "(", ")" )
--empty

remove left-right pair. If right does not exist, the PairDict is unchanged

empty
|>insert ( "(", ")" )
|>removeRight "(" --unchanged, "(" is not a right value
|>removeRight ")" --removes ( "(", ")" )
--empty

values on the left

brackets=
  fromList [ ( '(', ')' ), ( '{', '}' ) ]
opening= lefts brackets

values on the right

brackets=
  fromList [ ( '(', ')' ), ( '{', '}' ) ]
closing= rights brackets

Reduce the left-right Pairs from most recently inserted to least recently inserted. A fold in the other direction doesn't exist, as association-Dicts should rarely rely on order (see equal)

brackets=
  fromList
    [ ( '(', ')' )
    , ( '{', '}' )
    ]
openingAndClosing=
  brackets
  |>fold
      (\( left, right ) acc->
        acc ++[ String.fromList [ left, right ] ]
      )
      []

[ "{}", "()" ]

map pairs

digitNames=
  fromList
    [ ( 0, "zero" )
    , ( 1, "one" )
    ]
mathSymbolNames=
  digitNames
  |>map (Pair.mapLeft String.fromInt)
  |>insert ( "+", "plus" )

Convert to an association-Dict, which you can access only from the left

casedLetters=
  fromList
    [ ( 'A', 'a' ), ( 'B', 'b' ) ]
lowerFromUpper=
  casedLetters |>dictFromLeft

Convert a PairDict to a Json.Encode.Value.

somePairDict=
  empty
  |>insert ( 1, 11 )
  |>insert ( 2, 22 )
Encode.encode 1
  (encode
    Encode.int Encode.int
    somePairDict
  )




"""
[
 {
  \"left\": 2,
  \"right\": 22
 },
 {
  \"left\": 1,
  \"right\": 11
 }
]
"""