# `grp` --- 群組資料庫

該模組提供對 Unix 群組資料庫的存取， 所有 Unix 版本皆可使用。

可用性: Unix, not WASI, not Android, not iOS.

群組資料庫條目以類似 tuple 物件的方式報傳入， 其屬性對應於 `group` 結構的成員（屬性欄位如下， 請參閱 `<grp.h>`）：

索引 | 屬性 | 含義
--- | --- | ---
0 | gr_name | 群組名稱
1 | gr_passwd | （被加密後的）群組密碼；大部分情況下是空的
2 | gr_gid | 群組的數字 ID
3 | gr_mem | 所有群組成員的使用者名稱

gid 是整數，name 和 password 是字串， 而 member list 是字串串列。（請注意， 根據密碼資料庫， 大多數使用者並未被明確列為其所在群組的成員。 請檢查這兩個資料庫，以取得完整的成員資訊。 另外請注意，以 `+` 或 `-` 開頭的 `gr_name` 很可能是 YP/NIS 參照，可能無法透過 `getgrnam()` 或 `getgrgid()` 取得）。

它定義了以下項目：

grp.getgrgid(id)

  回傳給定群組 ID 的群組資料庫條目。 `KeyError` 會在找不到所要求的條目時被引發。

  在 3.10 版的變更: `TypeError` 會在非整數的引數如浮點數或字串被傳入時被引發。

grp.getgrnam(name)

  回傳給定群組名稱的群組資料庫條目。 `KeyError` 會在找不到所要求的條目時引發。

grp.getgrall()

  以任意順序傳回所有可用群組條目的串列。

也參考

`pwd` 模組

  使用者資料庫的介面，與此類似。