gpt4 book ai didi

c++ - C/C++ 头文件文档

转载 作者:IT老高 更新时间:2023-10-28 22:06:32 24 4
gpt4 key购买 nike

您认为在 C++ 中创建公共(public)头文件时的最佳做法是什么?

  1. 头文件应该不包含、简短或大量的文档吗?我已经看到了从几乎没有文档(依赖于一些外部文档)到不变量、有效参数、返回值等的大型规范的所有内容。我不确定我到底喜欢什么,大型文档很好,因为你总是可以访问它来自您的编辑器,另一方面,带有非常简短文档的头文件通常可以在一两页文本上显示完整的界面,从而更好地概述类可以做什么。

  2. 假设我使用简短或大量文档之类的东西。我想要类似于 javadoc 的东西,我在其中记录返回值、参数等。c++ 中最好的约定是什么?据我所知,doxygen 在 java doc 样式文档方面做得很好,但是在使用 javadoc 样式文档之前我应该​​了解其他任何约定和工具吗?

最佳答案

通常我将接口(interface)的文档(参数、返回值、函数的作用)放在接口(interface)文件(.h)中,并将实现的文档(如何 em> 函数所做的)在实现文件(.c、.cpp、.m)中。

我在声明之前写了一个类的概述,所以读者可以立即获得基本信息。

我使用的工具是 Doxygen。

关于c++ - C/C++ 头文件文档,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/487114/

24 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com