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.

This function is deprecated. It will be renamed in a future release since the name is misleading.

Encode a Mac address as colon-separated hexadecimal octets, preferring lowercase for alphabetical characters.

>>> BBB.run Nat.constant $ boundedBuilderUtf8 $ mac 0xDEADBEEF1609
[0x64, 0x65, 0x3a, 0x61, 0x64, 0x3a, 0x62, 0x65, 0x3a, 0x65, 0x66, 0x3a, 0x31, 0x36, 0x3a, 0x30, 0x39]

Lenient decoding of MAC address. This is case insensitive and allows either : or - as the separator. It also allows leading zeroes to be missing.

>>> decodeUtf8Bytes (Bytes.fromAsciiString "A2:DE:AD:BE:EF:67")
Just (mac 0xa2deadbeef67)
>>> decodeUtf8Bytes (Bytes.fromAsciiString "13-a2-FE-A4-17-96")
Just (mac 0x13a2fea41796)

Leniently parse UTF-8-encoded Bytes as a Mac address. This is case insensitive and allows either : or - as the separator. It also allows leading zeroes to be missing.

>>> Parser.parseBytes (parserUtf8Bytes ()) (Bytes.fromAsciiString "de:ad:BE:EF:1:23")
Success (Slice {offset = 16, length = 0, value = mac 0xdeadbeef0123})

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.