f#語言有兩種注釋方法。
行注釋為只有一行的注釋。
塊注釋是從"(*"到"*)"之間的注釋。
行注釋
//行注釋。只注釋這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;;
對程式的內容這裡不做解釋,只說明一下這是返回數值的平方的程式。
要想將注釋輸出到xml檔案中,請在命令列編輯視窗(cmd.exe)中,轉到f#的安裝目錄下的bin目錄中(fsc.exe工具在該目錄中),並做如下工作。
輸出程式注釋
> fsc --doc doc.xml a.fs
a.fs是源程式檔名,doc.xml是要輸出xml的xml檔名。
輸出的xml檔案內容如下
輸出的xml檔案
<?xml version="1.0" encoding="utf-8"?>a輸出數值的平方
到visualstudio2003版為止,都具有將注釋生成api文件的功能。visualstudio2005版以後就被廢除了。因此,要想將這個xml檔案生成api文件,可以使用visualstudio2005版之後提供的ndoc等文件生成工具。
最新版本的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 = ()
#r,是指在命令列中追加引用的語句。print_endline函式包含在fsharp.powerpack.dll檔案中,因此引用fsharp.powerpack.dll,從而使用print_endline函式。
第二章 第二節 注釋
零 怎麼編寫注釋 編寫注釋的方式有三種 1.以 開頭 2.以三個 開頭和結尾 3.以三個 開頭和結尾 定義乙個字串變數 name 張三 定義乙個函式 defgetname return name defsetname n param n 姓名 return name n defsetage age ...
F 入門 第二章 F 基礎 第十二節 列表
列表是資料的集合。f 的列表是線性列表的一種,單方向列表。單方向列表是基本的資料結構之一,一種攜帶指向下乙個元素的指標的資料結構。列表中的元素必須是相同資料型別。完全沒有元素的列表叫空列表,用來表示。另外,列表中的元素用 來分隔。列表 val it a list 1 val it int list ...
F 入門 第二章 F 基礎 第八節 for迴圈
本節對f 中的for迴圈進行介紹。以下是f 中的基本的for迴圈的編寫方法。for迴圈 for語句1 for 迴圈變數 表示式1 to 表示式2 do 表示式3 done for語句2 for 迴圈變數 in 表示式4 do 表示式5 done for語句1是c語言風格的迴圈方式。for語句2是一般...