// SPDX-FileCopyrightText: © 2026 Jeffrey C. Ollie // 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()); } }