我们在编写代码的时候，最头疼的就属于说明书了，很多代码一边写具体代码，一边写说明书，Doxygen主要解决说明书问题，可以在我们写代码的时候讲注释转化为说明书，Graphviz主要是用于图形展示，html help workshop主要使用生成CHM文档。 1.Doxygen
作为维护人员，如果收到的补丁明显与周围代码的编码风格不同，这是令人沮丧的。这是不尊重人的，就像某人穿着泥泞的鞋子走进一间一尘不染的房子。
大家好，我是唐唐，今天我又找了一篇编码规范分享大家，感觉超级好，可以规避掉很多bug~。
为了控制 clang 的运行，clang 必须支持不同的参数对各种行为进行控制，所以，clang driver 启动后的第一个主要任务就是 参数解析
编写高质量代码并非易事，即使对于经验非常丰富的开发者也是如此。通过向我们的解决方案中添加测试，我们可以减少在业务代码中犯明显错误的风险。但这还不足以避免更复杂的问题。每一段软件都由如此多的细节组成，跟踪它们全部成为了一份全职工作。团队维护产品达成了数十种约定和多种特殊设计实践。
首先，关于VA助手的破解安装教程，请参考：VS2015 Visual Assist X 破解版安装教程
文档在所有软件项目中都是必不可少的：对于用户，解释如何获取和构建代码，并说明如何有效地使用您的代码或库，对于开发者，描述库的内部细节，并帮助其他程序员参与并贡献于您的项目。本章将展示如何使用 CMake 构建代码文档，使用两个流行的框架：Doxygen 和 Sphinx。
官方提供的是OpenNI的接口，接下来就探索一下相关的资源，接着就是在ARM的设备上面的安装使用。
1. 知识点一：查看整数范围 当前的编译环境下，你可能不知道int的数据范围是多少，或者记不清无符号短整型的范围是0~65535还是0~65536?这时候就可以按照如下程序进行输出查看： #inclu
在C语言中设置了许多的预定义符号，这些预定义符号是可以直接使用的，预定义符号也是在预处理阶段进行处理的。
在 sdk style 的项目格式支持使用多框架开发，此时需要在代码里面通过宏判断，在编译的时候执行不同的代码。本文告诉大家在框架里面对应的预定义的条件编译符有哪些
我们平常在写代码的时候，特别是在制造轮子的时候(为别人提供库文件)，会遇到各种不同的需求场景：
文档代码同源，故名思意，就是文档和代码都写在源代码文件里。这样可以：1.修改代码的时候就及时修改文档，使得文档和代码及时保持一致；2.阅读代码时，增加代码的可读性。评审代码的时候，尤其是修改时后，即对文档一同评审。结合研发流程、评审的配合，可促使代码、文档的开发逐步走向一一对应，逐步向高质量发展，同时也能提高团队素质。
fn - Rust 语言使用 fn 关键字定义函数。main() 函数是一个预定义的主函数，充当 Rust 程序的入口点，每个语言都会有自己的 main() 函数。 println!() 是 Rust 语言中的一个 预定义的宏。它用于将传递给它的参数输出到 标准输出。
版权声明：本文为博主原创文章，转载请注明源地址。 https://blog.csdn.net/10km/article/details/51105863
原始的 TeX 引擎不支持彩色，有关彩色的功能都是由输出 PS、PDF 格式的 TeX 引擎或驱动提供的，有关命令是在绘图相关的扩展宏包中定义的。基本的彩色支持工具是 color 宏包，它是 LaTeX 的基本组件，graphics 工具包的一部分。
GCC 会为不同 CPU 架构预定义宏，如 __x86_64__ 代表Intel 64位CPU， __aarch64__代表 ARM64。 网上已经有文档对 GCC 为 CPU 的预定义宏进行了总结。
只有当函数只有10行甚至更少时才会将其定义为内联函数（inline function)。当函数体比较小的时候，内联该函数可以令目标代码更加高效。内联那些包含循环或switch语句的函数是得不偿失的。如果一个inline函数会在多个源文件中被用到，那么必须把它定义在**.h头文件**中。 定义函数时，参数顺序为：输入参数在前，输出参数在后。这一点并不是必须遵循的规则，输入/输出两用参数（通常是类/结构体变量）混在其中，会使得规则难以遵循。 包含文件的名称及次序：C库、C++库、其他库的.h、项目
有一部分代码只是用来调试使用，不期望在发布的时候执行。也有一些代码只是用来测试性能，也不期望在其他时候使用。在做源代码包的时候，我需要对不同的平台使用不同的代码。此时就可以用到条件编译符，在不同的条件下编译不同的代码
🎬 鸽芷咕：个人主页 🔥 个人专栏:《C语言初阶篇》 《C语言进阶篇》
define的常见用法 1.基本用法undefined在编译时期进行替换。如：#define Sum(a,b) a+b //定义为一个基本替换，把Sum(a,b) 替换成a+b.#define INTERFACE //就是说名这是一个接口，只是起到注释作用 #define STR(s) #s //表示s是一个字符串 //如： int a = 0; cout<<"the value of "<< STR(a) << " is: " << a<<endl; #define JOIN(A,B) A##B
文章来自 http://www.uml.org.cn/c++/200902104.asp 在将一个C源程序转换为可执行程序的过程中, 编译预处理是最初的步骤. 这一步骤是由预处理器(preprocessor)来完成的. 在源流程序被编译器处理之前, 预处理器首先对源程序中的"宏(macro)"进行处理. C初学者可能对预处理器没什么概念, 这是情有可原的: 一般的C编译器都将预处理, 汇编, 编译, 连接过程集成到一起了. 编译预处理往往在后台运行. 在
我们已经掌握了构建专业项目的所有必要知识；我们学习了结构化、构建、依赖管理、测试、分析、安装和打包。是时候将这些学到的技能付诸实践，通过创建一个连贯、专业的项目。
前段时间公司里做项目要求遵循doxygen文档规范，并且在Windows XP下安装了Doxygen 1.8.4版本，使用起来能查看头文件是否遵循doxygen规范和一些简单的错误，另外还可以根据C或者C++源代码生成对应的API文档，尤其是生成html格式的话就更方便了。
实现一个TODO宏 转载http://blog.sunnyxx.com/2015/03/01/todo-macro/ 实现一个能产生warning的TODO宏，用于在代码里做备忘，效果： 下面一步步来
if defined(symbol)/ifdef symbol if !defined(symbol)/ifndef symbol
前面的博客中我们已经讲过了预处理是什么，本期我们就来详细的讲述一下预处理这个概念。
Doxygen是一款非常方便的文档生成工具，以类似JavaDoc风格描述的文档系统，完全支持C、C++、Java等语言，据说也支持python等。用他不仅可以根据注释生成文档，而且还能利用graphviz工具生成类图以及类中的函数调用关系，并且支持html、latex、rtf等格式的输出。
以前，我们学C语言的时候，多多少少都查过一些标准库函数吧。这里介绍查找C语言的标准库函数的两种方法：一种方法是直接到http://www.cplusplus.com这个网站上去查看：
我们平时写的代码，都是文本信息的代码，是源代码（源文件）。我们需要通过翻译环境把它翻译为可执行程序（.exe）（2进制指令），只有二进制指令，计算机才能够读懂和执行。有了可执行程序，通过执行环境（运行环境）运行之后才能产生我们想要的结果。
NumPy 社区已经确立了改进其文档的坚定目标。我们定期在 Zoom 上举行文档会议（日期在numpy-discussion 邮件列表上宣布），欢迎每个人参与。如果你有问题或需要有人指导你迈出第一步 - 我们很乐意帮助。 会议记录在hackmd.io上，存储在NumPy 存档存储库中。
本文档主要用来指导和建议工程师如何写好软件代码的注释，方便使用Doxygen生成文档
Debug 和 Release 并没有本质的区别，他们只是VC预定义提供的两组编译选项的集合，编译器只是按照预定的选项行动。如果我们愿意，我们完全可以把Debug和Release的行为完全颠倒过来。当然也可以提供其他的模式，例如自己定义一组编译选项，然后命名为MY_ABC等。习惯上，我们仍然更愿意使用VC已经定义好的名称。
对于涉及跨平台开发的项目,就可能会遇到数据大小端的问题，其实就是一个数字在内存中的字节序的问题，判断当前系统是大小端有现成的例子，自己实现转换代码也非常方便,网上有好多不用多说。 但我是个懒人，就算是这么简单的代码，有现成的就不想自己写。 今天要说的是gcc本身已经提供了大小端的判断和数据转换的函数，真的没必要自己写。
通常的目标是：书写一个像包含一个单独的函数调用语句的宏， 这意味着：调用者需要提供最终的分号，而宏体则不需要。因此宏体不能为简单的括弧包围的复合语句，因为如果这样，调用的时候就会发生语法错（明显是一个单独语句，但却多了一个分号）。
我们知道在使用switch时，如果步骤特别繁琐，那么每次都得加个break，很麻烦，所以我们想了一种方式。
（1）宏是一种抽象，他根据一系列预定义的规则替换一定的文本模式，而解释器或编译器在遇到宏时会自动进行这一模式替换，可以理解为变量。
基本规则是，在当前编译阶段之后的任何编译阶段都不能被引用。在当前阶段或更早阶段编译的任何内容都是完全可用的。
CLI宏是一种生产力工具，可让您在IDA的命令行界面（Python，IDC，WinDbg，BochDbg，Gdb等）中定义和使用静态或动态宏。
Boost是一个强大的C++第三方库，但是Boost的各种问题实在是很让人蛋疼。我搜到过一篇文章关于LuaBind使用Boost Build管理工具来管理源代码以及编译的博文，其第一句话就是Fuck The Boost！it is the pain of ass!
平时需要测试一些比较模糊的知识点，或则想要验证一些函数时，我们常常会建一个test.c文件，然后在这个文件里写我们的测试代码，测试完毕后常常会删掉该文件。下次再遇到同样的问题的时候，可能又是记不清楚了，常常又需要测试一遍，这是件很浪费时间的事情。
让 CMake 支持 gdb 的设置也很容易，只需要指定 Debug 模式下开启 -g 选项：
今天国庆放假的第一天, 饿得无聊就出来找东西吃, 转着转着就来到公司了. 就我一人, 真爽 想想这几天看看N3吧, 工作上的事情还是按计划来 上作者blog一看, 又有新东西啦, 大体翻译一下: 我最后还是抽出时间打包了一个新的N3 SDK. 我会在星期一回到办公室时上传上去, 同时这里有一个大体的列表. 很多底层的东西改变了, 所以我不得不移除一些不错的前台特性(如在实现了多线程的渲染器后N2的角色渲染必须删除, 并且届时shader光照的代码会出错). 我会在下一个release版本中去考虑这些前
Doxygen是一个代码文档生成工具。它从代码文件中提取注释并可生成多种文档形式。如：网页文档HTML，RTF (MS-Word)，PDF等等。同时也可生成函数之间的调用和文件的依赖关系图表。
http://doxygen.nl/files/doxygen-1.8.17-setup.exe
http://www-numi.fnal.gov/offline_software/srt_public_context/WebDocs/doxygen-howto.html
领取专属 10元无门槛券
手把手带您无忧上云
云服务器
ICP备案
对象存储
即时通信 IM
腾讯会议
