Construct a Mac address from a Word64. Only the lower 48 bits are used.

Create a Mac address from six octets.

Convert a Mac address to the six octets that make it up. This function and fromOctets are inverses:

m == (let (a,b,c,d,e,f) = toOctets m in fromOctets a b c d e f)

Encode a Mac address using the default MacCodec defCodec.

>>> T.putStrLn (encode (Mac 0xA47F247AB423))
a4:7f:24:7a:b4:23

Encode a Mac address using the given MacCodec.

>>> m = Mac 0xA47F247AB423
>>> T.putStrLn $ encodeWith defCodec m
a4:7f:24:7a:b4:23

>>> T.putStrLn $ encodeWith (MacCodec (MacGroupingTriples '-') True) m
A47-F24-7AB-423

Decode a Mac address using the default MacCodec defCodec.

>>> decode (Text.pack "a4:7f:24:7a:b4:23")
Just (mac 0xa47f247ab423)

>>> decode (Text.pack "a47-f24-7ab-423")
Nothing

Decode a Mac address from Text using the given MacCodec.

>>> decodeWith defCodec (Text.pack "a4:7f:24:7a:b4:23")
Just (mac 0xa47f247ab423)

>>> decodeWith (MacCodec MacGroupingNoSeparator False) (Text.pack "a47f247ab423")
Just (mac 0xa47f247ab423)

Encode a Mac address as a Builder.

Parse a Mac address using a Parser.

>>> AT.parseOnly parser (Text.pack "a4:7f:24:7a:b4:23")
Right (mac 0xa47f247ab423)

>>> AT.parseOnly parser (Text.pack "a47-f24-7ab-423")
Left "':': Failed reading: satisfy"

Parser a Mac address using the given MacCodec.

>>> p1 = parserWith defCodec
>>> AT.parseOnly p1 (Text.pack "a4:7f:24:7a:b4:23")
Right (mac 0xa47f247ab423)

>>> p2 = parserWith (MacCodec MacGroupingNoSeparator False)
>>> AT.parseOnly p2 (Text.pack "a47f247ab423")
Right (mac 0xa47f247ab423)

Encode a Mac address using the default MacCodec defCodec.

>>> BC.putStrLn (encodeUtf8 (mac 0x64255A0F2C47))
64:25:5a:0f:2c:47

Encode a Mac address as a ByteString using the given MacCodec.

>>> m = Mac 0xA47F247AB423
>>> BC.putStrLn $ encodeWithUtf8 defCodec m
a4:7f:24:7a:b4:23

>>> BC.putStrLn $ encodeWithUtf8 (MacCodec (MacGroupingTriples '-') True) m
A47-F24-7AB-423

Lenient decoding of MAC address that accepts lowercase, uppercase, and any kind of separator.

>>> decodeUtf8 "A2:DE:AD:BE:EF:67"
Just (mac 0xa2deadbeef67)
>>> decodeUtf8 "13-a2-fe-a4-17-96"
Just (mac 0x13a2fea41796)
>>> decodeUtf8 "0A42.47BA.67C2"
Just (mac 0x0a4247ba67c2)

Decode a ByteString as a Mac address using the given MacCodec.

>>> decodeWithUtf8 defCodec (BC.pack "64:25:5a:0f:2c:47")
Just (mac 0x64255a0f2c47)

>>> decodeWithUtf8 (MacCodec MacGroupingNoSeparator False) (BC.pack "64255a0f2c47")
Just (mac 0x64255a0f2c47)

Make a bytestring builder from a Mac address using a colon as the separator.

Lenient parser for a Mac address using any character as the separator and accepting any digit grouping (i.e. FA:43:B2:C0:0F:99 or A065.647B.87FA).

Parser for a Mac address using the provided settings.

Decode a Mac address from a ByteString. Each byte is interpreted as an octet of the Mac address. Consequently, ByteStrings of length 6 successfully decode, and all other ByteStrings fail to decode.

>>> decodeBytes (B.pack [0x6B,0x47,0x18,0x90,0x55,0xC3])
Just (mac 0x6b47189055c3)
>>> decodeBytes (B.replicate 6 0x3A)
Just (mac 0x3a3a3a3a3a3a)
>>> decodeBytes (B.replicate 7 0x3A)
Nothing

Print a Mac address using the textual encoding.

A 48-bit MAC address. Do not use the data constructor for this type. It is not considered part of the stable API, and it allows you to construct invalid MAC addresses.

A MacCodec allows users to control the encoding/decoding of their Mac addresses.

The format expected by the mac address parser. The Word8 taken by some of these constructors is the ascii value of the character to be used as the separator. This is typically a colon, a hyphen, or a space character. All decoding functions are case insensitive.