如何在C++中模拟方法依赖参数查找以简化寄存器API调用？

我正在设计一款嵌入式编程寄存器API，很多函数支持用户选择若干值（比如3个）来设置特定寄存器位。我希望函数接收带有明确语义名称的枚举作为参数，但目前调用时必须重复冗长的命名空间或类路径：

USB2_OTG_FS::hostPortControl.setPortSpeed(USB2_OTG_FS::HostPortControl::PortSpeed::FullSpeed)

理想的调用方式是：

USB2_OTG_FS::hostPortControl.setPortSpeed(PortSpeed::FullSpeed)
// 甚至可以把setPortSpeed重载简化为set

但C++原生不支持这种“方法依赖参数查找”机制，我需要一种高效的模拟方案，既要避免用户用using污染作用域，又要避免调用过于冗长。

底层结构伪代码：

namespace USB2_OTG_FS {
    class HostPortControl {
    public:
        enum class PortSpeed {
            FullSpeed = 0b01
        };

        void setPortSpeed(PortSpeed portSpeed);
    } hostPortControl;
}

1. 类内定义枚举别名（C++11+） #

在HostPortControl类内部给强类型枚举定义一个同名别名，利用类作用域的查找规则，让成员函数能直接识别PortSpeed：

namespace USB2_OTG_FS {
    class HostPortControl {
    public:
        enum class PortSpeed {
            FullSpeed = 0b01
        };
        // 类内别名，仅在类作用域生效，不会污染外部
        using PortSpeed = PortSpeed;

        void setPortSpeed(PortSpeed portSpeed);
        // 可选：重载为set，靠参数类型区分操作
        void set(PortSpeed portSpeed) { setPortSpeed(portSpeed); }
    } hostPortControl;
}

调用时直接写：

USB2_OTG_FS::hostPortControl.set(PortSpeed::FullSpeed);

这个方案完全符合需求，既不用using污染全局，又大幅缩短了调用代码。

2. 枚举提升到命名空间（带语义前缀） #

如果允许调整结构，把枚举移到USB2_OTG_FS命名空间下，给枚举名加上类相关前缀避免冲突：

namespace USB2_OTG_FS {
    enum class HostPortSpeed {
        FullSpeed = 0b01
    };

    class HostPortControl {
    public:
        void setPortSpeed(HostPortSpeed portSpeed);
        void set(HostPortSpeed portSpeed) { setPortSpeed(portSpeed); }
    } hostPortControl;
}

调用时简化为：

USB2_OTG_FS::hostPortControl.set(USB2_OTG_FS::HostPortSpeed::FullSpeed);

这个方案适合需要在多个类间共享枚举的场景，只要枚举名足够独特就不会有冲突。

3. 类内定义静态枚举常量（C++11+） #

如果枚举值不多，可以在类内为每个枚举值定义静态常量，连PortSpeed::都能省掉：

namespace USB2_OTG_FS {
    class HostPortControl {
    public:
        enum class PortSpeed {
            FullSpeed = 0b01
        };

        // 为每个枚举值定义类内静态常量
        static constexpr PortSpeed FullSpeed = PortSpeed::FullSpeed;

        void setPortSpeed(PortSpeed portSpeed);
        void set(PortSpeed portSpeed) { setPortSpeed(portSpeed); }
    } hostPortControl;
}

调用时直接通过对象或类访问常量：

USB2_OTG_FS::hostPortControl.set(USB2_OTG_FS::hostPortControl.FullSpeed);
// 或者用类名访问
USB2_OTG_FS::hostPortControl.set(USB2_OTG_FS::HostPortControl::FullSpeed);

这个方案进一步简化了书写，适合枚举值数量少的寄存器操作场景。

4. 拆分命名空间利用ADL（进阶） #

把枚举放到和类同名的子命名空间里，结合ADL特性辅助查找，同时类内定义别名确保调用简洁：

namespace USB2_OTG_FS {
    namespace HostPortControl {
        enum class PortSpeed {
            FullSpeed = 0b01
        };
    }

    class HostPortControl {
    public:
        using PortSpeed = HostPortControl::PortSpeed;

        void setPortSpeed(PortSpeed portSpeed);
        void set(PortSpeed portSpeed) { setPortSpeed(portSpeed); }
    } hostPortControl;
}

调用方式和第一种方案一致，这个结构适合把枚举和类实现拆分到不同文件的大型项目。

内容的提问来源于stack exchange，提问作者Julien BERNARD