Something went wrong. Try again.
A small Zig library for parsing and formatting IEEE 802 MAC addresses.
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323// SPDX-FileCopyrightText: © 2026 Jeffrey C. Ollie <jeff@ocjtech.us>// SPDX-License-Identifier: MIT
const MacAddress = @This();
const std = @import("std");
data: u48,
inline fn fromHex(c: u8) error{NotAMacAddress}!u4 { const tbl = tbl: { var tmp: [256]?u4 = undefined; for (0..256) |i| { tmp[i] = switch (i) { '0'...'9' => @truncate(i - '0'), 'a'...'f' => @truncate(i - 'a' + 10), 'A'...'F' => @truncate(i - 'A' + 10), else => null, }; } break :tbl tmp; };
return tbl[c] orelse error.NotAMacAddress;}
pub fn parse(data: []const u8) error{NotAMacAddress}!MacAddress { const raw = std.mem.trim(u8, data, &std.ascii.whitespace); switch (raw.len) { // 001122334455 12 => { var tmp: u48 = 0; for (raw) |c| { tmp = (tmp << 4) | try fromHex(c); } return .{ .data = tmp, }; }, // 0011.2233.4455 14 => { var tmp: u48 = 0; for (raw, 0..) |c, i| { switch (i) { 4, 9 => { switch (c) { '.' => {}, else => return error.NotAMacAddress, } }, else => { tmp = (tmp << 4) | try fromHex(c); }, } } return .{ .data = tmp, }; }, // 00 11 22 33 44 55 // 00:11:22:33:44:55 // 00-11-22-33-44-55 17 => { var tmp: u48 = 0; for (raw, 0..) |c, i| { switch (i) { 2, 5, 8, 11, 14 => { switch (c) { ' ', ':', '-' => {}, else => return error.NotAMacAddress, } }, else => { tmp = (tmp << 4) | try fromHex(c); }, } } return .{ .data = tmp, }; }, else => return error.NotAMacAddress, }}
test parse { { const m: MacAddress = try .parse("001122334455"); try std.testing.expectEqual(0x001122334455, m.data); } { const m: MacAddress = try .parse("66778899aabb"); try std.testing.expectEqual(0x66778899aabb, m.data); } { const m: MacAddress = try .parse("ccddeeffAABB"); try std.testing.expectEqual(0xccddeeffaabb, m.data); } { const m: MacAddress = try .parse("CCDDEEFF0011"); try std.testing.expectEqual(0xccddeeff0011, m.data); } { const m: MacAddress = try .parse("0011.2233.4455"); try std.testing.expectEqual(0x001122334455, m.data); } { const m: MacAddress = try .parse("00 11 22 33 44 55"); try std.testing.expectEqual(0x001122334455, m.data); } { const m: MacAddress = try .parse("00:11:22:33:44:55"); try std.testing.expectEqual(0x001122334455, m.data); } { const m: MacAddress = try .parse("00-11-22-33-44-55"); try std.testing.expectEqual(0x001122334455, m.data); } { // too long try std.testing.expectError( error.NotAMacAddress, MacAddress.parse("0011223344556"), ); } { // too long try std.testing.expectError( error.NotAMacAddress, MacAddress.parse("0011.2233.44556"), ); } { // too long try std.testing.expectError( error.NotAMacAddress, MacAddress.parse("00:11:22:33:44:55:66"), ); } { // invalid character try std.testing.expectError( error.NotAMacAddress, MacAddress.parse("00g122334455"), ); } { // invalid separator try std.testing.expectError( error.NotAMacAddress, MacAddress.parse("00;11;22;33;44;55"), ); } { // invalid separator try std.testing.expectError( error.NotAMacAddress, MacAddress.parse("0011;2233;4455"), ); }}
pub const Case = enum(u1) { upper = 0, lower = 1,};
pub const Style = enum { compact, cisco, spaces, colons, hyphen, dash, minus,};
pub fn format(self: *const MacAddress, writer: *std.Io.Writer) std.Io.Writer.Error!void { try self.formatOptions(writer, .default);}
test format { { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x001122aabbcc }; try w.print("{f}", .{m}); try std.testing.expectEqualStrings("00:11:22:AA:BB:CC", w.buffered()); }}
pub const FormatOptions = struct { case: Case = .upper, style: Style = .colons,
pub const default: @This() = .{};};
pub fn formatOptions( self: *const MacAddress, writer: *std.Io.Writer, options: FormatOptions,) std.Io.Writer.Error!void { const tbl = tbl: { var tmp: [2][256][2]u8 = undefined; inline for (std.meta.fields(Case)) |field| { const a = switch (@as(Case, @enumFromInt(field.value))) { .upper => "0123456789ABCDEF", .lower => "0123456789abcdef", }; for (&tmp[field.value], 0..) |*p, n| { p[0] = a[(n >> 4) & 0xf]; p[1] = a[(n >> 0) & 0xf]; } }
break :tbl tmp; };
var bytes: [6]u8 = undefined; std.mem.writeInt(u48, &bytes, self.data, .big);
switch (options.style) { // 001122334455 .compact => { for (bytes) |n| { try writer.writeAll(&tbl[@intFromEnum(options.case)][n]); } }, // 0011.2233.4455 .cisco => { for (bytes, 0..) |n, i| { switch (i) { 2, 4 => try writer.writeByte('.'), else => {}, } try writer.writeAll(&tbl[@intFromEnum(options.case)][n]); } }, // 00 11 22 33 44 55 // 00:11:22:33:44:55 // 00-11-22-33-44-55 .spaces, .colons, .hyphen, .dash, .minus => { const c: u8 = switch (options.style) { .spaces => ' ', .colons => ':', .hyphen, .dash, .minus => '-', else => unreachable, }; for (bytes, 0..) |n, i| { if (i != 0) try writer.writeByte(c); try writer.writeAll(&tbl[@intFromEnum(options.case)][n]); } }, }}
test formatOptions { { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x001122334455 }; try m.formatOptions(&w, .{ .case = .upper, .style = .compact }); try std.testing.expectEqualStrings("001122334455", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x66778899aabb }; try m.formatOptions(&w, .{ .case = .upper, .style = .compact }); try std.testing.expectEqualStrings("66778899AABB", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0xccddeeff0011 }; try m.formatOptions(&w, .{ .case = .upper, .style = .compact }); try std.testing.expectEqualStrings("CCDDEEFF0011", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x001122334455 }; try m.formatOptions(&w, .{ .case = .upper, .style = .cisco }); try std.testing.expectEqualStrings("0011.2233.4455", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x001122334455 }; try m.formatOptions(&w, .{ .case = .upper, .style = .spaces }); try std.testing.expectEqualStrings("00 11 22 33 44 55", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x001122334455 }; try m.formatOptions(&w, .{ .case = .upper, .style = .colons }); try std.testing.expectEqualStrings("00:11:22:33:44:55", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x001122334455 }; try m.formatOptions(&w, .{ .case = .lower, .style = .hyphen }); try std.testing.expectEqualStrings("00-11-22-33-44-55", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0x66778899aabb }; try m.formatOptions(&w, .{ .case = .lower, .style = .compact }); try std.testing.expectEqualStrings("66778899aabb", w.buffered()); } { var buffer: [17]u8 = undefined; var w: std.Io.Writer = .fixed(&buffer); const m: MacAddress = .{ .data = 0xccddeeff0011 }; try m.formatOptions(&w, .{ .case = .lower, .style = .compact }); try std.testing.expectEqualStrings("ccddeeff0011", w.buffered()); }}