扩展现有 API：使用默认参数还是包装函数？

发布于 2024-07-23 05:00:06 字数 602 浏览 4 评论 0原文

我有一个现有的方法（或一般的函数），我需要增加额外的功能，但我不想破坏代码中其他地方对该方法的任何使用。示例：

int foo::bar(int x)
{
 // a whole lot of code here
 return 2 * x + 4;
}

在代码库中广泛使用。现在我需要将 4 设为参数，但任何已经调用 foo::bar 的代码仍应收到它所期望的内容。我应该扩展并重命名旧方法并将其包装到新方法中，

int foo::extended_bar(int x, int y)
{
 // ...
 return 2 * x + y;
}

int foo::bar(int x)
{
 return extended_bar(x,4);
}

还是应该在头文件中声明一个默认参数

int bar(int x, int y=4);

，然后扩展函数

int foo::bar(int x, int y)
{
 // ...
 return 2 * x + y;
}

每个变体的优点和缺点是什么？

原文

I have an existing method (or function in general) which I need to grow additional functionality, but I don't want to break any use of the method elsewhere in the code. Example:

int foo::bar(int x)
{
 // a whole lot of code here
 return 2 * x + 4;
}

is widely used in the codebase. Now I need to make the 4 into a parameter, but any code that already calls foo::bar should still receive what it expects. Should I extend and rename the old method and wrap it into a new one like

int foo::extended_bar(int x, int y)
{
 // ...
 return 2 * x + y;
}

int foo::bar(int x)
{
 return extended_bar(x,4);
}

or should I declare a default argument in the header file like

int bar(int x, int y=4);

and just extend the function

int foo::bar(int x, int y)
{
 // ...
 return 2 * x + y;
}

What are advantages and disadvantages of each variant?

分享到QQ

分享到微博

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

需要登录才能够评论，你可以免费注册一个本站的账号。

萧瑟寒风 2024-07-30 05:00:06

我通常使用包装函数（大多数时候通过重载）而不是默认参数。

原因是存在两个级别的向后兼容性：

具有源代码级向后兼容性意味着您必须在不进行任何更改的情况下重新编译调用代码，因为新的函数签名与旧的兼容。两者都可以达到这个水平；默认值和包装器/重载。
更强的级别是二进制级向后兼容性，甚至无需重新编译即可工作，例如，当您无权访问调用代码时。想象一下，您以二进制形式部署函数，例如在 DLL 中等。在这种情况下，签名必须完全相同才能使其正常工作，而默认值则不然 - 它们会破坏这种兼容性级别.

包装函数的另一个优点是 - 如果您的应用程序具有任何类型的日志记录 - 您可以在旧函数中转储警告，该函数将在未来版本中过时，并且建议使用新函数。