开发者社区

文档建议反馈控制台

最新优惠活动

文章/答案/技术大牛

发布

在C中的公共API函数中使用枚举参数是一个好主意吗？

在C中的公共API函数中使用枚举参数是一个好主意。枚举参数可以提供更清晰和可读性强的代码，使得函数的使用更加直观和易于理解。枚举参数可以定义一组相关的常量，并将其作为函数的参数进行传递。这样可以避免使用数字或字符串等不直观的方式来表示选项或状态。

使用枚举参数的好处包括：

可读性强：枚举参数可以使用自定义的标识符来表示选项或状态，使得代码更易于理解和维护。
类型安全：枚举参数可以限制函数参数的取值范围，避免传入无效的参数值。
扩展性强：当需要添加新的选项或状态时，只需在枚举类型中添加新的常量即可，而不需要修改函数的接口。
编译时检查：使用枚举参数可以在编译时检查参数的合法性，减少运行时错误的可能性。

然而，使用枚举参数也需要注意以下几点：

枚举类型的定义应该与函数的使用场景相匹配，避免定义过于复杂或冗余的枚举类型。
枚举参数的取值应该具有明确的语义，避免过于模糊或歧义的取值。
在函数的实现中，应该对枚举参数进行适当的错误处理，例如检查参数的合法性并返回错误码或抛出异常。

总结起来，使用枚举参数可以提高代码的可读性和可维护性，同时也能够提供类型安全和编译时检查的好处。在设计公共API函数时，如果枚举参数能够清晰地表示函数的选项或状态，那么使用枚举参数是一个好主意。

腾讯云相关产品和产品介绍链接地址：

腾讯云官网：https://cloud.tencent.com/
云服务器（CVM）：https://cloud.tencent.com/product/cvm
云原生应用引擎（TKE）：https://cloud.tencent.com/product/tke
云数据库 MySQL 版（CMYSQL）：https://cloud.tencent.com/product/cmysql
云存储（COS）：https://cloud.tencent.com/product/cos
人工智能（AI）：https://cloud.tencent.com/product/ai
物联网（IoT）：https://cloud.tencent.com/product/iotexplorer
移动开发（移动推送、移动分析）：https://cloud.tencent.com/product/mobile
区块链（BCS）：https://cloud.tencent.com/product/bcs
元宇宙（Tencent Real-Time 3D）：https://cloud.tencent.com/product/trtc

相关搜索:如果(TRUE)在C中是个好主意吗？构造函数中的业务逻辑是一个好主意吗？c ++使用按位或"|"在一个函数参数中的多个枚举在Objective-C中保留/释放方法参数是一个好主意吗？使用REST API在base64中上传视频是个好主意吗？将图存储在MySQL中是一个好主意吗？构造函数中的React属性析构。是个好主意吗？在函数中设置为参数的Python枚举在表格单元格中添加uiwebviews是一个好主意吗？重用VB6中的变量是一个好主意吗？使用"这个"是真的吗？在c#中的参数使用更多内存之前？使用C++中的私有函数覆盖公共虚函数在函数中仅使用一个默认参数的C++Swift参数在Objective C函数中不可见吗？在linux下使用dlopen() api时，可以在_init()函数中添加参数吗？使用Subject来通知其他组件在Angular中执行操作是个好主意吗 Swift:使用枚举的原始值来访问常量数组中的UIButton和字符串是个好主意吗？将ID存储在ElasticSearch索引的_type字段中是个好主意吗？我在选择函数中传递参数的方式是错误的吗？在php中创建函数来生成一些html内容是个好主意吗？

相关搜索:

页面内容是否对你有帮助？

有帮助

没帮助

相关·内容

Unity基础教程系列（九）——形状行为（Modular Functionality）

当前，所有形状都可以移动和旋转，但这并不是它们唯一能做的。我们可以想出一些希望形状表现出来的不同行为。要使形状做其他事情，只需将其代码添加到Shape.GameUpdate中即可。但是，如果我们定义很多行为的话，那么该方法将变得非常庞大。另外，我们可能不希望所有形状的表现都相同。

04

javascript中bind绑定接收者与函数柯里化

如果我已经把匿名函数抽象出来，做成了一个公共的方法（可能其他地方也会用的到）那么，这个遍历会是这样的；

02

伙计们，Go 并没有那么简单

出于好奇，我最近开始接触一些 Go 的代码。我之前对它有一些了解，但是从来没有尝试去写（没有需求）。但是现在我们团队选择使用 Go 来开发一个项目，所以我觉得这是一个获得实际经验的好机会。到目前为止，关于这门语言我已经学习了很长时间。在这个博文的末尾，我会写更多关于 Go 的干货。社区实际上并不那么令人愉快，特别是那些因为它的简单性而主张使用 Go 的人。似乎简单已经成为 Go 社区中的一个流行语，许多人反复重复提到这点，却没有给出太多实际的想法。这对我来说似乎很不幸，因为在我看来，Go 是一个“极其

06

C ++ 中不容忽视的 25 个 API 错误设计！

对于许多C ++开发人员来说，API设计可能会在其优先级列表中排名第3或第4。大多数开发人员都倾向于使用C ++来获得原始功能和控制权。因此，性能和优化的想法占据这些开发者的时间的百分之八十。

02

深入理解 Java17 新特性：Sealed Classes

鉴于Java全球影响力和高兼容性承诺，语言功能设计错误代价非常高。如语言功能存在缺陷，保持兼容性不仅意味很难移除或显著改变功能，且现有功能还会限制未来功能发展。新功能要通过实际使用来验证，开发人员的反馈至关重要。为确保在快速发布节奏下有足够的时间进行实验和反馈，新语言功能将通过一或多个轮次的预览来测试，这些功能是平台的一部分，但需要单独选择进入，并且尚未成为永久功能，以便在根据开发人员的反馈进行调整时，不会破坏关键代码。

00

高级 PHP 工程师必备的编码技巧及思维

好的开发者通常以代码质量来定义。在软件行业，写好的代码意味着在在测试，更新，扩展或者修复漏洞中省钱。本文，我将向你展示一些现实生活中技巧和想法的例子，来帮助你清理你的逻辑代码，重构它，让它变得更健壮和模块化。这些技巧将不仅仅帮助你重构你的旧代码，而且给你一些如何从现在开始写出简洁代码的好建议。

06

如何对第一个Vue.js组件进行单元测试（下）

让我们来写首个测试。我们首先需要使用shallowMount手动挂载我们的组件，并将其存储在我们将执行断言的变量中。我们还可以通过propsData属性传递道具作为对象。

00

数据库PostrageSQL-升级一个PostgreSQL集簇

当前PostgreSQL版本号由主要版本号和次要版本号组成。例如，在版本号10.1中，10是主要版本号，1是次要版本号，这意味着这将是主版本10的第一个次要版本。对于PostgreSQL版本10.0之前的版本，版本号由三个数字组成，例如9.5.3。在这些情况下，主要版本由版本号的前两个数字组（例如9.5）组成，次要版本是第三个数字，例如3，这意味着这将是主要版本9.5的第三次要版本。

01

Swift基础访问控制

翻译自：https://docs.swift.org/swift-book/LanguageGuide/AccessControl.html

00

Swift入门：枚举

枚举(Enumerations)通常称为“ enum”，发音为“ ee-num”，是一种在Swift中定义自己的值的方法。在某些编程语言中，它们只是简单的小事，但是Swift给它们增加了巨大的功能。

02

干货 | 国外大神总结的10个Java编程技巧！

“任何可能出错的事情，最后都会出错。”这就是人们为什么喜欢进行“防错性程序设计”的原因。

01

联合迭代器与生成器，enumerate() 内置函数真香！

花下猫语：Python 中很多内置函数的作用都非常大，比如说 enumerate() 和 zip()，它们使得我们在作迭代操作时极为顺手。这是一篇很多年前的 PEP，提议在 Python 2.3 版本中引入 enumerate()，该文档整合了其它几篇 PEP 的想法（包括当时新引入的迭代器与生成器），提出了更好的实现方案以及函数名。经过这么多年的发展，enumerate() 不可避免地有了一些变化，但不变的是，它跟 19 年前一样，还是很有必要、很好用，用着真香！

00

介绍OpenTelemetry（第1/2部分）

作者：Ran Ribenzaft，Epsagon联合创始人和首席执行官。嘉宾文章最初在Epsagon博客上发表。

04

国外大神总结的 10 个 Java 编程技巧！

原文： http://www.javacodegeeks.com/2015/08/top-10-useful-yet-paranoid-java-programming-techniques.html 译文： http：//www.importnew.com/16805.html 这是一个国外大神20多年的经验总结出来的…… “任何可能出错的事情，最后都会出错。” 这就是人们为什么喜欢进行“防错性程序设计”的原因。偏执的习惯有时很有意义，有时则不够清晰也不够聪明，也许当你想到这样写的人的时候还会觉得有点怪异

02

Ibatisnet介绍

介绍欢迎来到iBATISNet Database Layer!这个框架将让你能够更好的在dotnet应用中设计和实现实体层。这个框架有两个主要的组成部分，一个是SQL Maps，另一个是Data Access Objects。 SQL Maps Sql Maps是这个框架中最激动人心的部分，它是整个iBATIS Database Layer的核心价值所在。通过使用Sql Maps你可以显著的节约数据库操作的代码量。SQL Maps使用一个简单的XML文件来实现从实体到SQL statements的映射。跟

06

国外大神总结的 10 个 Java 编程技巧！

这是一个国外大神20多年的经验总结出来的…… “任何可能出错的事情，最后都会出错。” 这就是人们为什么喜欢进行“防错性程序设计”的原因。偏执的习惯有时很有意义，有时则不够清晰也不够聪明，也许当你想到这

02

使用declare(strict_types=1)来获得更健壮的PHP代码

如果您是PHP开发人员，您可能在某些PHP文件的开头看到过declare(strict_types=1)语句。

01

[书籍]重温《Framework Design Guidelines》

《Framework Design Guidelines》中文名称为《.NET设计规范约定、惯用法与模式》，简介如下：

04

如何用Swift重写C++/ObjC代码库，并将其缩减70%

作者 | Ron Avitzur 译者 | 刘雅梦策划 | Tina 疫情期间，作者花了 18 月的时间，将图形计算器（Graphing Calculator）从 C++/ObjC 移植到了 Swift 上，将代码量缩减为原来的 30%，并且没有明显的功能或性能损失。图形计算器（Graphing Calculator）始于 1985 年，是为了 128K Macintosh 用 C 语言编写的，当时它仅有 16 位整数、黑白 Quickdraw 以及不带 MMU、FPU 和 GPU 的 8MH

04

Effective Java（第三版）——条目十六：在公共类中使用访问方法而不是公共属性

“ 有时候，你可能会试图写一些退化的类（degenerate classes），除了集中实例属性之外别无用处”

01

SwiftUI 布局：如何自定义 AlignmentGuides

SwiftUI 为我们提供了视图不同边缘的对齐指南（.leading、trailing、top等）以及.center和两个基线选项来帮助文本对齐。

01

框架设计原则和规范（二）

此文是《.NET：框架设计原则、规范》的读书笔记，本文内容较多，共分九章，将分4天进行推送，今天推送4-5章。 1. 什么是好的框架 2. 框架设计原则 3. 命名规范 4. 类型设计规范 5. 成员设计规范 6. 扩展性设计 7. 异常 8. 使用规范 9. 设计模式 1. 类型设计规范确保每个类型由一组定义明确、互相关联的成员组成，而不仅仅是一些无关功能的随机集合 1.1. 类型和名字空间 1.1.1. 用名字空间把类型组织成一个相关的功能区结

05

使用腾讯云 serverless 部署语雀飞书机器人

代码地址：https://github.com/gusibi/yuque_webhook

00

掌握 Swift 中的 reduce 操作符，使你的代码更高效

Swift 的 Sequence 类型有一个强大的操作符叫做 reduce，它允许你将序列的所有元素组合成一个单一的值。在处理来自 App Store Connect API 的响应时，我一直在反复使用它，我觉得写一篇关于它的博客文章是个好主意。

02

框架设计原则和规范（四）

祝大家平安夜平安，圣诞节快乐！此文是《.NET：框架设计原则、规范》的读书笔记，本文内容较多，共分九章，将分4天进行推送，今天推送最后两章。 1. 什么是好的框架 2. 框架设计原则 3. 命名规范 4. 类型设计规范 5. 成员设计规范 6. 扩展性设计 7. 异常 8. 使用规范 9. 设计模式一、使用规范 1. 数组 1) 要在公共API中优先使用集合，避免使用数组。 2) 不要使用只读（readonly）的数组字段。这种数组用户仍然可以修改数组中的元素 3) 考虑使用不规则数组（jagged

04

探讨|使用或不使用机器学习

机器学习擅长解决某些复杂问题，通常涉及特征和结果之间的困难关系，这些关系不能轻易地硬编码为启发式或 if-else 语句。然而，在决定 ML 是否是当前给定问题的良好解决方案时，有一些限制或需要注意的事项。在这篇文章[1]中，我们将深入探讨“使用或不使用 ML”这一主题，首先了解“传统”ML 模型，然后讨论随着生成式 AI 的进步，这种情况将如何变化。

02

<Solidity学习系列二>深入理解Solidity之二---Solidity源代码文件结构

版本Pragma 源文件可以（也应该）用所谓的版本注释来注释，以拒绝被编译为未来可能引入不兼容更改的编译器版本。我们试图将这种变化保持在绝对最低限度，特别是引入变化的方式是语义的变化也需要语法的变化，但这当然不总是可能的。因此，至少对于包含重大更改的版本，通读更新日志总是一个好主意，这些版本始终具有0.x.0或x.0.0格式的版本。

02

FastAPI框架诞生的缘由（下）

原文：https://fastapi.tiangolo.com/alternatives/

02

Python 3.10发布临近，一文尽览所有重要新特性和变化

Python 3.10 的发布日益临近，是时候来看看它将带来的最重要的新特性和变化了。内容包括类型检查，类型别名，switch/case语法，数量统计，上下文管理器，性能等。

03

API 与 SPI

API 是应用编程接口(Application Programing Interface) , 是为调用方提供服务或函数的一种方法。 SPI 是服务提供接口(Service Provider Interface)，是为第三方扩展功能的一种方法。

03

Python 为什么要保留显式的 self ？

布鲁斯·埃克尔（Bruce Eckel）发了篇博文[1]，提议从类方法的形参列表中删除“self”。我将解释为什么这个提议不能通过。（译注：Bruce 是《Thinking in Java》、《Thinking in C++》等多本书籍的作者，也是个 Python 开发者。他的文章总结了当年在巴西 Pycon 上的一次讨论，主要观点是在定义类方法时，形参中的“self”是多余的，而且由它引发的报错信息具有一定的误导性。）

03

数据库PostrageSQL-日志文件维护

把数据库服务器的日志输出保存在一个地方是个好主意，而不是仅仅通过/dev/null丢弃它们。在进行问题诊断的时候，日志输出是非常宝贵的。不过，日志输出可能很庞大（特别是在比较高的调试级别上），因此你不会希望无休止地保存它们。你需要轮转日志文件，这样在一段合理的时间后会开始新的日志文件并且移除旧的。

02

Python的众多包管理器

Python 是一种很棒的编程语言。我用它来构建网络应用程序、深度学习模型、游戏和数值计算。然而，Python 的一个方面多年来一直是令人难以忍受的痛苦。那就是碎片化的 Python 包和环境管理生态系统，可以用以下 XKCD 漫画简洁地表示：

01

智能合约Stack Too Deep解决方法

InternalCompilerError：Stack Too Deep, try removing local variables.(堆栈太深，请尝试删除一些局部变量。)

00

编写干净的C#代码技巧

在当今时代，编写代码并不困难。然而，编写干净且可伸缩的代码并不容易。在本文中，我们将讨论一些为我们的项目编写干净C#代码的技巧。乍一看，任何以前从未见过您的代码的开发人员都必须尽可能地理解它，它帮助我们更好地理解代码。

03

工作流程，编程，调试，性能：Unity游戏开发者应该学习的20个改进技巧

Unity 是一个备受欢迎的游戏开发平台。它的功能令人印象深刻，同时也迎合了不同的游戏开发需求。游戏开发者可以使用 Unity 创建任何类型的游戏，从世界级的 RPG 游戏到最流行的增强现实游戏 PokêmonGo。随着世界各地的广泛使用，许多开发人员在网络上用 Unity 来炫技，有些甚至在游戏发布前就能疯狂圈粉！此外，许多初学者都利用 Unity 来学习游戏开发或游戏编程。由于 Unity 的复杂性 -- 它涵盖了设计、脚本、调试和游戏开发的其他各项方面 -- 它可能难以管理。下面介绍一些关于 Unity 的技巧，让大家用起来更为得心应手。

09

Python 为什么要保留显式的 self ？

布鲁斯·埃克尔（Bruce Eckel）发了篇博文[1]，提议从类方法的形参列表中删除“self”。我将解释为什么这个提议不能通过。（译注：Bruce 是《Thinking in Java》、《Thinking in C++》等多本书籍的作者，也是个 Python 开发者。他的文章总结了当年在巴西 Pycon 上的一次讨论，主要观点是在定义类方法时，形参中的“self”是多余的，而且由它引发的报错信息具有一定的误导性。）

03

「微服务架构」API版本控制最佳实践介绍

变化是不可避免的，增长是一件好事。当您的API已经超出了最初的意图和容量时，就该考虑下一个版本了。

01

词法作用域

作用域共有两种主要的工作模式，第一种最为普遍，被大多数编语言所采用的词法作用域，另一种叫做动态作用域，仍有一些编程语言在使用（Bash脚本、Perl中的一些模式等）

01

译｜调整JavaScript抽象的迭代方案

原文作者：Kaloyan Kosev 原文链接：https://css-tricks.com/adapting-javascript-abstractions-time/ 翻译译者：小溪里校对：华翔

09

iOS图形处理概论：OpenGL ES，Metal，Core Graphics，Core Image，GPUImage，Scene Kit (3D) ，Sprite Kit (2D)，OpenCV

对于刚接触iOS图形相关框架的小白，有一些图形框架在字面上和功能上非常容易混淆。这里旨在总结一下各种框架，区分它们的概念和功能，以作日后进一步细分学习的指引。因而，本文并不会针对具体框架作详解，只作区分引导，读者可自行选择方向继续深造。为此，笔者总结了一张各种框架关系图，如下所示：

04

在使用Java 8并行流之前要考虑两次

如果您倾听来自Oracle的人们谈论Java 8背后的设计选择，您会经常听到并行性是主要动机。并行化是lambdas，流API和其他方面的驱动力。我们来看一下流API的示例。

04

Kubernetes如何降低云的复杂性

Kubernetes过度用于安全性和基础设施，但未充分用于自动化。那些最需要它的人并没有意识到它的潜力。

02

Unity基础教程系列（七）——可配置形状（Variety of Randomness）

这是有关对象管理的系列教程中的第七篇。它为形状增加了一些行为，并可以针对每个生成区域配置它们。

03

给程序员的 8 个提高开发效率的建议

作为一名开发人员，保持高效并不容易。这是一项精神压力大的工作，会很快耗尽精力，也需要大量的注意力。了解如何专注于工作、使用自动化走捷径以及处理分心的事情可以帮助您充分利用工作时间。在本篇文章中，您可以找到我们为开发人员和程序员提供的最佳生产力技巧，从寻找最佳开发人员工具到定期休息，再到成功消除工作时的干扰。

02

一文弄懂Python代码规范

这份文档为主Python发行版中标准库的Python代码提供了编码规范。请参阅相关的信息性PEP，该PEP描述了Python C实现中的C代码的样式指南。

01

从 RUST 库中公开 FFI

Wikipedia 将 FFI 定义为一种机制，通过这种机制，用一种编程语言编写的程序可以调用或使用用另一种编程语言编写的服务。

03

SkeyeGisMap地图扩展(一)---添加形状

在任何时候都不要直接操作地图节点(即 Map*Node ), 因为地图节点位于渲染线程。

01

48条高效率的PHP优化写法

1 字符串 1.1 少用正则表达式能用PHP内部字符串操作函数的情况下，尽量用他们，不要用正则表达式，因为其效率高于正则。没得说，正则最耗性能。 str_replace函数要比preg_replace快得多，strtr函数又比str_replace来得快。有没有你漏掉的好用的函数？例如：strpbrk()、strncasecmp()、strpos()、strrpos()、stripos()、strripos()。 1.2 字符替换如果需要转换的全是单个字符，用字符串作为 strtr() 函数完成

48 条高效率的 PHP 优化写法

能用PHP内部字符串操作函数的情况下，尽量用他们，不要用正则表达式，因为其效率高于正则。

03

扫码

添加站长进交流群

领取专属 10元无门槛券

手把手带您无忧上云

扫码加入开发者社群

相关资讯

热门标签

活动推荐

运营活动

活动名称

广告关闭