這是一個建立於 的文章,其中的資訊可能已經有所發展或是發生改變。
os/user 使用者模組
匯入文法:
import "os/user"
模組概述
os/user 模組的主要作用是通過使用者名稱或者 id 從而擷取其相關屬性。
User 結構體
type User struct { Uid string Gid string Username string Name string HomeDir string}
User 代表一個使用者賬戶:
- Uid :使用者的 ID
- Gid :使用者所屬組的 ID,如果屬於多個組,那麼此 ID 為主組的 ID
- Username :使用者名稱
- Name :屬組名稱,如果屬於多個組,那麼此名稱為主組的名稱
- HomeDir :使用者的宿主目錄
User 結構體的主要方法
Current
func Current() (*User, error)
返回目前使用者。
Lookup
func Lookup(username string) (*User, error)
通過使用者名稱尋找使用者,如果沒有找到這個使用者那麼將返回 UnknownUserError 錯誤類型。
LookupId
func LookupId(uid string) (*User, error)
通過使用者識別碼 尋找使用者,如果沒有找到這個使用者那麼將返回 UnknownUserIdError 錯誤類型。
驗證程式
package mainimport ( "fmt" "os/user" "reflect")func main() { fmt.Println("== 測試 Current 正常情況 ==") if u, err := user.Current(); err == nil { fmt.Println("使用者ID: " + u.Uid) fmt.Println("主組ID: " + u.Gid) fmt.Println("使用者名稱: " + u.Username) fmt.Println("主組名: " + u.Name) fmt.Println("家目錄: " + u.HomeDir) }
fmt.Println("== 測試 Lookup 正常情況 ==") if u, err := user.Lookup("root"); err == nil { fmt.Println("使用者ID: " + u.Uid) fmt.Println("主組ID: " + u.Gid) fmt.Println("使用者名稱: " + u.Username) fmt.Println("主組名: " + u.Name) fmt.Println("家目錄: " + u.HomeDir) } fmt.Println("== 測試 Lookup 異常情況 ==") if _, err := user.Lookup("roo"); err == nil { } else { fmt.Println("錯誤資訊: " + err.Error()) fmt.Print("錯誤類型: ") fmt.Println(reflect.TypeOf(err)) }
fmt.Println("== 測試 LookupId 正常情況 ==") if u, err := user.LookupId("0"); err == nil { fmt.Println("使用者ID: " + u.Uid) fmt.Println("主組ID: " + u.Gid) fmt.Println("使用者名稱: " + u.Username) fmt.Println("主組名: " + u.Name) fmt.Println("家目錄: " + u.HomeDir) } fmt.Println("== 測試 LookupId 異常情況 ==") if _, err := user.LookupId("10000"); err == nil { } else { fmt.Println("錯誤資訊: " + err.Error()) fmt.Print("錯誤類型: ") fmt.Println(reflect.TypeOf(err)) }}
輸出結果如下:
== 測試 Current 正常情況 ==使用者ID: 0主組ID: 0使用者名稱: root主組名: root家目錄: /root== 測試 Lookup 正常情況 ==使用者ID: 0主組ID: 0使用者名稱: root主組名: root家目錄: /root== 測試 Lookup 異常情況 ==錯誤資訊: user: unknown user roo錯誤類型: user.UnknownUserError== 測試 LookupId 正常情況 ==使用者ID: 0主組ID: 0使用者名稱: root主組名: root家目錄: /root== 測試 LookupId 異常情況 ==錯誤資訊: user: unknown userid 10000錯誤類型: user.UnknownUserIdError