大白话rust系列01注释

大家好,这是大白话讲rust系列的第一讲

希望通过这个系列,本人能慢慢掌握rust的精髓,也希望读者朋友通过本系列能有所收获

在AI时代下,越来越多的文章充满了AI味或者完全是AI输出的

本系列会尽量保证文章的内容是古法手敲,代码验证完好。并且内容足够通俗易懂。

话不多说,开始发车了

这一讲先讲注释。写过代码的朋友都会想,注释有什么好讲的?其实,里面的东西还是有点意思的。远不是两个斜杠这么简单

单行注释

复制代码
fn main() {
    //这是一个注释
    println!("Hello, world!");

    let name     /*代码种的注释 */ = "chen";

    /*这是一个
       这是一个
       这是一个
       这是一个
       这是一个
       这是一个
       这是一个
       这是一个
       多行注释*/

}

上面的代码展示了两种单行注释和多行注释。其实从这一小段代码,能看到比较有趣的东西

println!怎么带了个问号?

这是一个宏调用,而不是普通函数调用,不用担心忘记写这个叹号,不写的话编译器会直接给你报错。Rust 中有很多宏:

复制代码
println!()
print!()
format!()
vec![]
panic!()

这里暂时先不说宏调用是什么,记一下这个关键字即可。运行一下这个代码吧

虽然没有报错,但是有一个警告,说name被定义了但是没有使用它,这个在编译器看来其实是一些无用代码。如果你就是要定义一个变量然后不使用它,可以在在前面加上下划线

改为_name后,果然没有warning啦。

文档注释

注意看,上述代码报错了,是因为,这个其实是一个文档注释!!!

/**注释内容*/ 这是文档注释,不管你是写了单行还是多行

/*注释内容*/ 这是单行或者多行注释

两者区别是文档注释多了一个星号~

另外,///也是文档注释。那么如何让文档注释编译的时候不报错?

文档注释后面带一点内容就行了,不管是方法还是局部变量啥的。文档注释是给外部人员看的,如果可以的话尽可能写的规范

在控制台输入cargo doc --open

rust会在当前工程的根目录下生成target/doc/hello_rust/index.html并且打开这个html

doc下不止生成了这一个html,还有其他一些,可以自己去跑一下代码看看

这个文档注释在写一些标准api给到外部人员时还是挺好用的

好了,第一讲关于注释不知不觉讲的有点多了,就此停住,下期再见,拜~

相关推荐
jimy11 小时前
c++的 Type Traits (一)
开发语言·c++
Web极客码2 小时前
Python Ollama 本地 Agent 入门与订单查询实践
开发语言·jvm·python
kimnoic3 小时前
PHP 8.2的DNF类型怎么用才规范
开发语言·php
_Evan_Yao3 小时前
前后端联调怎么排查问题?从 Network 到后端日志,一步步定位错误
开发语言·后端·团队开发·需求分析
hudd6683 小时前
JavaEE 初阶 - 多线程(进阶)
java·开发语言·java-ee
小白快快跑哦3 小时前
python-字符串全解(六):正则表达式-前后相断言
开发语言·python·正则表达式·前后相断言
kimnoic3 小时前
Python数据分析中正则表达式匹配字符串与常用函数示例详解
开发语言·python
中屹指纹浏览器svip3 小时前
打开账号环境网页报错,常见原因有哪些?
服务器·开发语言·php·中屹指纹浏览器
朝朝辞暮i4 小时前
第 01 讲:Python 变量、对象、数据类型与内存引用
开发语言·python
外收内放4 小时前
Python基础语法练习题(69)
开发语言·python