ncvlog帮助文档存放路径_这个神器可以提取你代码中的关键信息生成技术文档（附下载链接）...-CSDN博客

本文链接：https://blog.csdn.net/weixin_34094525/article/details/112444397

点击上方「嵌入式大杂烩」，选择「置顶公众号」第一时间查看编程笔记！

一、前言

以前，我们学C语言的时候，多多少少都查过一些标准库函数吧。这里介绍查找C语言的标准库函数的两种方法：一种方法是直接到http://www.cplusplus.com这个网站上去查看：

这里覆盖了C语言标准库中的所有函数，给出了每个函数的介绍并且都给出了具体的用法示例，比如：

但都是英文的说明。

另一种方法是，找一些离线的文档，网上有不少人整理了一些离线的文档，比如.chm格式(已编译的帮助文件)的文档：

里面的内容大概是这样子的：

也可以很方便的查找每个函数的用法，但是，这里面的不是很全，查找C标准库函数还是建议到http://www.cplusplus.com上面去查找。

本文分享的重点就是.chm文件的制作。最近需要对自己的一些代码做一些整理，发现整理成.chm文件是个不错的选择，.chm文件可以根据我们的代码生成，下面把生成.chm文件的方法分享给大家。

二、制作.chm文件的工具

需要三个工具：doxygen安装包、graphviz安装包、htmlhelp安装包。其中doxygen是一种开源跨平台的文档系统，doxygen可以从一套归档源文件开始，生成HTML格式的在线类浏览器，或离线的LATEX、RTF参考手册。

doxygen可以生成好几种格式的文档，要生成.chm格式的手册就必须安装htmlhelp，要生成关系图必须安装依graphviz。这个个工具的获取方法：

1、方法一：官网下载

(1)doxygen安装包：

http://www.doxygen.nl/download.html

(2)graphviz安装包：

http://www.graphviz.org/

(3)htmlhelp安装包：

https://www.microsoft.com/en-us/download/details.aspx?id=21138

2、方法二：百度云盘下载

方法一下载得很慢，但是，小编已经把这三个工具下载好了，并存放于百度云中，可在聊天界面回复关键词：chm，进行获取百度云分享链接。

下载的都是.exe格式的可执行文件，就按平时安装软件的方法安装件就可以了。但是，需要记住graphviz与htmlhelp的安装路径，后面使用Doxygen时需要用到。

三、Doxygen根据代码生成.chm的机制

Doxygen可以根据固定格式的代码注释生成相对应的.chm格式的手册。支持的语言有好多种，如C/C++/C#/Objective-C/PHP/Java等。这里主要是分享C语言，Doxygen可以识别的固定格式注释有以下几种：

这里，我使用的是第一种，如：

/**
 * 函数功能：字符串逆序函数
 * @param src_str：字符串
 * @param str_len:字符串长度
 * @return 逆序之后得到的字符串
 */ 
char *Str_ReverseOrder(char *src_str,int str_len){
    char *dst_str = src_str;
    char temp;
    printf("Method 1!\n");
    for(int i=0;i2;i++)
    {
        temp = src_str[i];                  
        src_str[i] = src_str[str_len-i-1];  
        src_str[str_len-i-1] = temp;        
    }return (char*)dst_str;
}