F#入门-第二章 F#基础-第二节 注释
2010-09-29 11:09
197 查看
F#语言有两种注释方法。
行注释为只有一行的注释。
块注释是从"(*"到"*)"之间的注释。
行注释
块注释1
※print_endline函数的使用方法在后文详述。
一般情况下以上两种注释方法就够了。F#还具有doc_comment这种功能用来生成API注释文档。F#编译器可以将从程序中的注释抽出,生成XML文档。
a.fs:要抽出注释的源程序文件
对程序的内容这里不做解释,只说明一下这是返回数值的平方的程序。
要想将注释输出到XML文件中,请在命令行编辑窗口(cmd.exe)中,转到F#的安装目录下的bin目录中(fsc.exe工具在该目录中),并做如下工作。
输出程序注释
a.fs是源程序文件名,doc.xml是要输出XML的XML文件名。
输出的XML文件内容如下
输出的XML文件
到VisualStudio2003版为止,都具有将注释生成API文档的功能。VisualStudio2005版以后就被废除了。因此,要想将这个XML文件生成API文档,可以使用VisualStudio2005版之后提供的NDoc等文档生成工具。
最新版本的F#中,不能直接使用print_endline函数。要想使用print_endline函数,需要在命令行中做如下准备工作。
print_endline函数
#r,是指在命令行中追加引用的语句。print_endline函数包含在FSharp.PowerPack.dll文件中,因此引用FSharp.PowerPack.dll,从而使用print_endline函数。
行注释为只有一行的注释。
块注释是从"(*"到"*)"之间的注释。
行注释
//行注释。只注释这1行 print_endline "hello world";; |
块注释1
(*块注释。 这里也是注释。 *) print_endline "hello world";; |
※print_endline函数的使用方法在后文详述。
一般情况下以上两种注释方法就够了。F#还具有doc_comment这种功能用来生成API注释文档。F#编译器可以将从程序中的注释抽出,生成XML文档。
a.fs:要抽出注释的源程序文件
//用utf-8保存 #light "off" ///返回数值的平方,注意此处为///,只有加了///的行能被输出 let square n=n*n;; print_any <| square 10 4000 ;; |
对程序的内容这里不做解释,只说明一下这是返回数值的平方的程序。
要想将注释输出到XML文件中,请在命令行编辑窗口(cmd.exe)中,转到F#的安装目录下的bin目录中(fsc.exe工具在该目录中),并做如下工作。
输出程序注释
> fsc --doc doc.xml a.fs |
输出的XML文件内容如下
输出的XML文件
<?xml version="1.0" encoding="utf-8"?> <doc> <assembly><name>a</name></assembly> <members> <member name="M:A.square(System.Int32)"> <summary> 输出数值的平方 </summary> </member> <member name="T:A"> </member> </members> </doc> |
最新版本的F#中,不能直接使用print_endline函数。要想使用print_endline函数,需要在命令行中做如下准备工作。
print_endline函数
> #r "FSharp.PowerPack.dll";; --> Referenced 'D:/p/fsharp/bin/FSharp.PowerPack.dll' > print_endline "Hello World";; Hello World val it : unit = () |
相关文章推荐
- 第二章 微服务网关基础组件 - zuul入门
- F#入门-第二章 F#基础-第十九节 option类型
- 第二章 PHP入门基础之php代码写法
- 网页编程基础第二章知识点总结——HTML&CSS快速入门
- F#入门-第二章 F#基础-第六节 匿名函数
- 第二章 微服务网关基础组件 - zuul入门
- F#入门-第二章 F#基础-第九节 while循环
- F#入门-第二章 F#基础-第十九节 模式匹配(一)
- Javascript 语言基础1(入门、script标签、注释、变量、调试办法、基本数据类型)
- Java入门-第二节-注释的类别以及标识符,关键字的认识
- java入门2-语言基础之关键字,标识符,注释,常量和变量
- F#入门-第二章 F#基础-第十二节 列表(list)
- F#入门-第二章 F#基础-第五节 let语句-函数定义
- F#入门-第二章 F#基础-第十五节 记录
- F#入门-第二章 F#基础-第一节 基本数据类型
- Ionic 入门与实战之第二章第二节:Ionic 环境搭建之 Ionic Lab 使用
- 第二章 PHP入门基础之php代码写法
- [Java入门笔记] Java语言基础(一):注释、标识符与关键字
- 2015年最新Android基础入门教程目录第二章:Android UI(User Interface)详解(已完结 40/40)
- F#入门-第二章 F#基础-第二十节 模式匹配(二)