包(package)
一個(gè)程序以一個(gè)包的形式構(gòu)建,這個(gè)包還可以使用其他包提供的一些設(shè)施。
一個(gè)golang程序的創(chuàng)建是通過(guò)鏈接一組包。
一個(gè)包可以由多個(gè)源碼文件組成。
導(dǎo)入包中的名字可以通過(guò)packagename.Itemname訪問(wèn)。
源碼文件結(jié)構(gòu)
golang每個(gè)源碼文件包括:
- 一個(gè)package字句(文件歸屬于哪個(gè)包);其名字將作為導(dǎo)入包時(shí)的默認(rèn)名字。
復(fù)制代碼 代碼如下:
package fmt
- 一個(gè)可選的import聲明集
復(fù)制代碼 代碼如下:
import "fmt" //使用默認(rèn)名字
import myFmt "fmt" //使用名字myFmt
- 0個(gè)或多個(gè)全局或“包級(jí)別”聲明。
單一文件包
復(fù)制代碼 代碼如下:
package main // 這個(gè)文件是包main的一部分
import "fmt" // 這個(gè)文件使用了包"fmt"
const hello = "Hello, 世界\n"
func main() {
fmt.Print(hello)
}
main和main.main
每個(gè)Go程序包含一個(gè)名為main的包以及其main函數(shù),在初始化后,程序從main開(kāi)始執(zhí)行。類似C,C++中的main()函數(shù)。
main.main函數(shù)沒(méi)有參數(shù),沒(méi)有返回值。當(dāng)main.main返回時(shí),程序立即退出并返回成功。
os包
os包提供Exit函數(shù)以及訪問(wèn)文件I/O以及命令行參數(shù)的函數(shù)等。
復(fù)制代碼 代碼如下:
// A version of echo(1)
package main
import (
"fmt"
"os"
)
func main() {
if len(os.Args) 2 { // length of argument slice
os.Exit(1)
}
for i := 1; i len(os.Args); i++ {
fmt.Printf("arg %d: %s\n", i, os.Args[i])
}
} // falling off end == os.Exit(0)
全局作用域與包作用域
在一個(gè)包中,所有全局變量、函數(shù)、類型以及常量對(duì)這個(gè)包的所有代碼可見(jiàn)。
對(duì)于導(dǎo)入該包的包而言,只有以大寫(xiě)字母開(kāi)頭的名字是可見(jiàn)的:全局變量、函數(shù)、類型、常量以及方法和結(jié)構(gòu)體中全局類型以及變量的字段。
復(fù)制代碼 代碼如下:
const hello = "you smell" // 包內(nèi)可見(jiàn)
const Hello = "you smell nice" //全局可見(jiàn)
const _Bye = "stinko!" // _不是大寫(xiě)字母
這與C/C++非常不同:沒(méi)有extern、static、private以及public。
初始化
有兩種方法可以在main.main執(zhí)行前初始化全局變量:
1) 帶有初始化語(yǔ)句的全局聲明
2) 在init函數(shù)內(nèi)部,每個(gè)源文件中都可能有init函數(shù)。
包依賴可以保證正確的執(zhí)行順序。
初始化總是單線程的。
初始化例子:
復(fù)制代碼 代碼如下:
package transcendental
import "math"
var Pi float64
func init() {
Pi = 4*math.Atan(1) // init function computes Pi
}
package main
import (
"fmt"
"transcendental"
)
var twoPi = 2*transcendental.Pi // decl computes twoPi
func main() {
fmt.Printf("2*Pi = %g\n", twoPi)
}
輸出: 2*Pi = 6.283185307179586
包與程序構(gòu)建
要構(gòu)建一個(gè)程序,包以及其中的文件必須按正確的次序進(jìn)行編譯。包依賴關(guān)系決定了按何種次序構(gòu)建包。
在一個(gè)包內(nèi)部,源文件必須一起被編譯。包作為一個(gè)單元被編譯,按慣例,每個(gè)目錄包含一個(gè)包,忽略測(cè)試,
復(fù)制代碼 代碼如下:
cd mypackage
6g *.go
通常,我們使用make; Go語(yǔ)言專用工具即將發(fā)布(譯注:Go 1中可直接使用go build、go install等高級(jí)命令,可不再直接用6g、6l等命令了。)
構(gòu)建fmt包
復(fù)制代碼 代碼如下:
% pwd
/Users/r/go/src/pkg/fmt
% ls
Makefile fmt_test.go format.go print.go # …
% make # hand-written but trivial
% ls
Makefile _go_.6 _obj fmt_test.go format.go print.go # …
% make clean; make
…
目標(biāo)文件被放在_obj子目錄中。
編寫(xiě)Makefiles時(shí)通常使用Make.pkg提供的幫助??丛创a。
測(cè)試
要測(cè)試一個(gè)包,可在這個(gè)包內(nèi)編寫(xiě)一組Go源文件;給這些文件命名為*_test.go。
在這些文件內(nèi),名字以Test[^a-z]開(kāi)頭的全局函數(shù)會(huì)被測(cè)試工具gotest自動(dòng)執(zhí)行,這些函數(shù)應(yīng)使用下面函數(shù)簽名:
復(fù)制代碼 代碼如下:
func TestXxx(t *testing.T)
testing包提供日志、benchmarking、錯(cuò)誤報(bào)告等支持。
一個(gè)測(cè)試?yán)?/strong>
摘自fmt_test.go中的一段有趣代碼:
復(fù)制代碼 代碼如下:
import (
"testing"
)
func TestFlagParser(t *testing.T) {
var flagprinter flagPrinter
for i := 0; i len(flagtests); i++ {
tt := flagtests[i]
s := Sprintf(tt.in, flagprinter)
if s != tt.out {
// method call coming up – obvious syntax.
t.Errorf("Sprintf(%q, flagprinter) => %q,"+" want %q", tt.in, s, tt.out)
}
}
}
gotest(譯注:在go 1中g(shù)otest工具用go test命令替代)
復(fù)制代碼 代碼如下:
% ls
Makefile fmt.a fmt_test.go format.go print.go # …
% gotest # by default, does all *_test.go
PASS
wally=% gotest -v fmt_test.go
=== RUN fmt.TestFlagParser
— PASS: fmt.TestFlagParser (0.00 seconds)
=== RUN fmt.TestArrayPrinter
— PASS: fmt.TestArrayPrinter (0.00 seconds)
=== RUN fmt.TestFmtInterface
— PASS: fmt.TestFmtInterface (0.00 seconds)
=== RUN fmt.TestStructPrinter
— PASS: fmt.TestStructPrinter (0.00 seconds)
=== RUN fmt.TestSprintf
— PASS: fmt.TestSprintf (0.00 seconds) # plus lots more
PASS
%
一個(gè)benchmark的測(cè)試?yán)?/p>
Benchmark的函數(shù)簽名如下:
復(fù)制代碼 代碼如下:
func BenchmarkXxxx(b *testing.B)
并被循環(huán)執(zhí)行b.N次;其余的由testing包完成。
下面是一個(gè)來(lái)自fmt_test.go中的benchmark例子:
復(fù)制代碼 代碼如下:
package fmt // package is fmt, not main
import (
"testing"
)
func BenchmarkSprintfInt(b *testing.B) {
for i := 0; i b.N; i++ {
Sprintf("%d", 5)
}
}
Benchmarking: gotest
復(fù)制代碼 代碼如下:
% gotest -bench="." # regular expression identifies which
fmt_test.BenchmarkSprintfEmpty 5000000
310 ns/op
fmt_test.BenchmarkSprintfString 2000000
774 ns/op
fmt_test.BenchmarkSprintfInt
5000000
663 ns/op
fmt_test.BenchmarkSprintfIntInt 2000000
969 ns/op
…
%
庫(kù)
庫(kù)就是包。
目前的庫(kù)規(guī)模是適中的,但還在增長(zhǎng)。
一些例子:
包 目的 例子
fmt 格式化I/O Printf、Scanf
os OS接口 Open, Read, Write
strconv numbers-> strings Atoi, Atof, Itoa
io 通用I/O Copy, Pipe
flag flags: –help等 Bool, String
log 事件日志 Logger, Printf
regexp 正則表達(dá)式 Compile, Match
template html等 Parse, Execute
bytes 字節(jié)數(shù)組 Compare, Buffer
更多關(guān)于fmt
fmt包包含一些熟悉的名字:
復(fù)制代碼 代碼如下:
Printf – 打印到標(biāo)準(zhǔn)輸出
Sprintf – 返回一個(gè)字符串
Fprintf – 寫(xiě)到os.Stderr等
還有
復(fù)制代碼 代碼如下:
Print, Sprint, Fprint – 無(wú)格式no format
Println, Sprintln, Fprintln – 無(wú)格式,但中間加入空格,結(jié)尾加入\n
fmt.Printf("%d %d %g\n", 1, 2, 3.5)
fmt.Print(1, " ", 2, " ", 3.5, "\n")
fmt.Println(1, 2, 3.5)
每個(gè)都輸出相同的結(jié)果:"1 2 3.5\n"
庫(kù)文檔
源碼中包含注釋。
命令行或web工具可以將注釋提取出來(lái)。
鏈接:http://golang.org/pkg/
命令:
復(fù)制代碼 代碼如下:
% godoc fmt
% godoc fmt Printf
您可能感興趣的文章:- MongoDB學(xué)習(xí)筆記(四) 用MongoDB的文檔結(jié)構(gòu)描述數(shù)據(jù)關(guān)系
- Go項(xiàng)目的目錄結(jié)構(gòu)詳解
- Go語(yǔ)言基礎(chǔ)知識(shí)總結(jié)(語(yǔ)法、變量、數(shù)值類型、表達(dá)式、控制結(jié)構(gòu)等)
- Go語(yǔ)言中的流程控制結(jié)構(gòu)和函數(shù)詳解
- go語(yǔ)言工程結(jié)構(gòu)