.bzl ファイル、BUILD、MODULE.bazel、WORKSPACE など、すべての Bazel ファイルで使用できるメソッド。
メンバー
- abs
- すべて
- 任意
- bool
- dict
- dir
- enumerate
- fail
- 浮動小数点数
- getattr
- hasattr
- ハッシュ
- 整数
- レンズ
- リスト
- max
- 分
- 印刷
- 範囲
- repr
- 反転
- 並べ替え
- str
- タプル
- type
- 郵便番号
abs
unknown abs(x)数値の絶対値(同じ大きさの正の数値)を返します。
abs(-2.3) == 2.3
パラメータ
パラメータ | 説明 |
---|---|
x
|
int;または float;
必須 数値(整数または浮動小数点数) |
すべて
bool all(elements)すべての要素が True と評価された場合、またはコレクションが空の場合に true を返します。要素は bool 関数を使用してブール値に変換されます。
all(["hello", 3, True]) == True all([-1, 0, 1]) == False
パラメータ
パラメータ | 説明 |
---|---|
elements
|
必須 文字列または要素のコレクション。 |
任意
bool any(elements)少なくとも 1 つの要素が True と評価された場合、true を返します。要素は bool 関数を使用してブール値に変換されます。
any([-1, 0, 1]) == True any([False, 0, ""]) == False
パラメータ
パラメータ | 説明 |
---|---|
elements
|
必須 文字列または要素のコレクション。 |
ブール値
bool bool(x=False)ブール値型のコンストラクタ。オブジェクトが
None
、False
、空の文字列(""
)、数値 0
、空のコレクション(()
、[]
など)の場合は False
を返します。それ以外の場合は True
を返します。
パラメータ
パラメータ | 説明 |
---|---|
x
|
デフォルトは False 変換する変数。 |
dict
dict dict(pairs=[], **kwargs)省略可能な位置引数と省略可能なキーワード引数からディクショナリを作成します。同じキーを複数回指定した場合は、最後の値が使用されます。キーワード引数で指定したエントリは、位置引数で指定したエントリより後とみなされます。
パラメータ
パラメータ | 説明 |
---|---|
pairs
|
デフォルトは [] 辞書、または要素の長さが 2 の反復可能オブジェクト(キー、値)。 |
kwargs
|
必須 追加エントリのディクショナリ。 |
dir
list dir(x)文字列のリスト(パラメータ オブジェクトの属性名とメソッド名)を返します。
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 チェックするオブジェクト。 |
列挙
list enumerate(list, start=0)インデックス(int)と入力シーケンスの項目を含むペア(2 要素のタプル)のリストを返します。
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]
パラメータ
パラメータ | 説明 |
---|---|
list
|
必須 生成します。 |
start
|
デフォルトは 0 開始インデックス。 |
fail
None
fail(msg=None, attr=None, *args)
実行がエラーで失敗します。
パラメータ
パラメータ | 説明 |
---|---|
msg
|
デフォルトは None 非推奨: 代わりに位置引数を使用してください。この引数は、暗黙的な先行位置引数として機能します。 |
attr
|
string;または None
デフォルトは None です 非推奨。この文字列を含むオプションの接頭辞がエラー メッセージに追加されます。 |
args
|
必須 エラー メッセージに表示される debugPrint(デフォルトでは str と同等)でフォーマットされ、スペースで結合された値のリスト。 |
float
float float(x=unbound)x を浮動小数点値として返します。
x
がすでに浮動小数点数の場合、float
は変更せずに返します。x
がブール値の場合、float
は true の場合は 1.0、false の場合は 0.0 を返します。x
が整数の場合、float
は x に最も近い有限浮動小数点値を返します。大きさが大きすぎる場合はエラーが返されます。x
が文字列の場合は、有効な浮動小数点リテラルにするか、NaN
、Inf
、Infinity
と等しい(大文字と小文字は区別しません)、必要に応じて+
記号または-
記号を付加する必要があります。
float()
は 0.0 を返します。
パラメータ
パラメータ | 説明 |
---|---|
x
|
デフォルトは unbound 変換する値。 |
getattr
unknown getattr(x, name, default=unbound)指定された名前の構造体のフィールド(存在する場合)を返します。ない場合は、
default
(指定されている場合)を返すか、エラーを発生させます。getattr(x, "foobar")
は x.foobar
と同等です。getattr(ctx.attr, "myattr") getattr(ctx.attr, "myattr", "mydefault")
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 属性にアクセスする構造体。 |
name
|
必須 構造体属性の名前。 |
default
|
デフォルトは unbound 構造体に指定された名前の属性がない場合の戻り値のデフォルト値。 |
hasattr
bool hasattr(x, name)オブジェクト
x
が、指定された name
の属性またはメソッドを持っている場合は True を返します。それ以外の場合は False を返します。例:hasattr(ctx.attr, "myattr")
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 チェックするオブジェクト。 |
name
|
必須 属性の名前。 |
ハッシュ
int hash(value)文字列のハッシュ値を返します。これは、Java の
String.hashCode()
と同じアルゴリズムを使用して確定的に計算されます。つまり、 s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]文字列以外の値のハッシュ化は現在サポートされていません。
パラメータ
パラメータ | 説明 |
---|---|
value
|
必須 ハッシュする文字列値。 |
int
int int(x, base=unbound)x を int 値として返します。
x
がすでに int の場合、int
は変更せずに返します。x
がブール値の場合、int
は true の場合は 1、false の場合は 0 を返します。x
が文字列の場合は、<sign><prefix><digits>
の形式にする必要があります。<sign>
は、"+"
、"-"
、空(正の値と解釈されます)のいずれかです。<digits>
は、0 からbase
- 1 までの数字のシーケンスです。10 ~ 35 の場合は、a ~ z(または同等の A ~ Z)の文字が使用されます。base
が 2/8/16 の場合、<prefix>
は省略可能で、それぞれ 0b/0o/0x(または同等の 0B/0O/0X)にできます。base
がこれらのベースまたは特殊な値 0 以外の値である場合、接頭辞は空にする必要があります。base
が 0 の場合、文字列は整数リテラルとして解釈されます。つまり、使用されている接頭辞(存在する場合)に応じて、基数 2、8、10、16 のいずれかが選択されます。base
が 0 の場合、接頭辞は使用されず、桁が複数ある場合は、先頭を 0 にすることはできません。これは 8 進数と 10 進数の混同を避けるためです。文字列で表される数値の桁数は、int 型で許容される範囲内である必要があります。x
が浮動小数点数の場合、int
は浮動小数点数の整数値を返します。この際、ゼロに丸められます。x が非有限(NaN または無限大)の場合はエラーになります。
x
が他の型の場合、または値が上記の形式を満たしていない文字列の場合、この関数は失敗します。Python の int
関数とは異なり、この関数では引数をゼロにすることはできません。また、文字列引数に余分な空白文字を含めることもできません。例:
int("123") == 123 int("-123") == -123 int("+123") == 123 int("FF", 16) == 255 int("0xFF", 16) == 255 int("10", 0) == 10 int("-0x10", 0) == -16 int("-0x10", 0) == -16 int("123.456") == 123
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 変換する文字列。 |
base
|
デフォルトは unbound 文字列値の解釈に使用されるベース。デフォルトは 10 です。2~36 の整数を指定するか、0 を指定すると、 x が整数リテラルであるかのように基数を検出します。値が文字列でない場合、このパラメータは指定できません。
|
len
int len(x)文字列、シーケンス(リストやタプルなど)、辞書、その他のイテラブルの長さを返します。
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 長さを報告する値。 |
list
list list(x=[])指定されたイテラブルの値と同じ要素を持つ新しいリストを返します。
list([1, 2]) == [1, 2] list((2, 3, 2)) == [2, 3, 2] list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]
パラメータ
パラメータ | 説明 |
---|---|
x
|
デフォルトは [] 変換するオブジェクト。 |
最大
unknown max(*args)指定されたすべての引数のうち最大の引数を返します。引数が 1 つだけ指定する場合は、空でないイテラブルである必要があります。要素が比較可能でない場合(たとえば、文字列型 int の場合)、または引数が指定されていない場合はエラーになります。
max(2, 5, 4) == 5 max([5, 6, 3]) == 6
パラメータ
パラメータ | 説明 |
---|---|
args
|
required チェックする要素。 |
分
unknown min(*args)指定されたすべての引数のうち、最小の引数を返します。引数を 1 つだけ指定する場合は、空でないイテラブルにする必要があります。要素が比較できない場合(int と文字列など)、または引数が指定されていない場合は、エラーになります。
min(2, 5, 4) == 2 min([5, 6, 3]) == 3
パラメータ
パラメータ | 説明 |
---|---|
args
|
required チェックする要素。 |
プリント
None
print(sep=" ", *args)
args
をデバッグ出力として出力します。先頭に、文字列 "DEBUG"
とこの呼び出しの場所(ファイル番号と行番号)が付加されます。引数が文字列に変換される具体的な方法は指定されていませんが、いつでも変更される可能性があります。特に、str()
や repr()
によって行われる書式設定とは異なる(より詳細な)場合があります。製品版のコードで print
を使用することは、ユーザーにスパムが発生するためおすすめしません。非推奨については、可能な限り fail()
を使用してハードエラーを取得することをおすすめします。
パラメータ
パラメータ | 説明 |
---|---|
sep
|
デフォルトは " " オブジェクト間の区切り文字列。デフォルトはスペース(「"」)です。 |
args
|
必須 出力するオブジェクト。 |
範囲
sequence range(start_or_stop, stop_or_none=None, step=1)
step
の増分を使用して、アイテムが start
から stop
に移動するリストを作成します。引数を 1 つ指定した場合、アイテムの範囲は 0~その要素になります。range(4) == [0, 1, 2, 3] range(3, 9, 2) == [3, 5, 7] range(3, 0, -1) == [3, 2, 1]
パラメータ
パラメータ | 説明 |
---|---|
start_or_stop
|
必須 停車地が指定されている場合は開始要素の値。それ以外の場合は停車地の値と実際の開始値は 0 |
stop_or_none
|
int;または None
デフォルトは None です 結果のリストに含めない最初のアイテムのオプションのインデックス。 stop に達する前にリストの生成が停止します。
|
step
|
デフォルトは 1 インクリメント(デフォルトは 1)。負の値になる場合があります。 |
repr
string repr(x)任意のオブジェクトを文字列表現に変換します。これはデバッグに役立ちます。
repr("ab") == '"ab"'
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 変換するオブジェクト。 |
反転
list reversed(sequence)元のイテラブルのシーケンスの要素を逆順で含む、新しいフリーズされていないリストを返します。
reversed([3, 5, 4]) == [4, 5, 3]
パラメータ
パラメータ | 説明 |
---|---|
sequence
|
必須 反転するイテレブル シーケンス(リストなど)。 |
並べ替え
list sorted(iterable, *, key=None, reverse=False)指定されたイテラブルのシーケンスのすべての要素を含む新しい並べ替えられたリストを返します。要素のペア x、y を x < y を使用して比較できない場合、エラーが発生することがあります。要素は昇順で並べ替えられますが、逆の引数が True の場合は降順です。 並べ替えは安定しています。比較結果が同じ要素は、元の相対順序を保持します。
sorted([3, 5, 4]) == [3, 4, 5]
パラメータ
パラメータ | 説明 |
---|---|
iterable
|
必須 並べ替えるイテラブル シーケンス。 |
key
|
デフォルトは None 比較の前に各要素に適用されるオプションの関数。 |
reverse
|
デフォルトは False 結果を降順で返します。 |
str
string str(x)任意のオブジェクトを文字列に変換します。これはデバッグに役立ちます。
str("ab") == "ab" str(8) == "8"
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 変換するオブジェクト。 |
tuple
tuple tuple(x=())指定された反復可能な値と同じ要素を持つタプルを返します。
tuple([1, 2]) == (1, 2) tuple((2, 3, 2)) == (2, 3, 2) tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)
パラメータ
パラメータ | 説明 |
---|---|
x
|
デフォルトは () 変換するオブジェクト。 |
type
string type(x)引数の型名を返します。これはデバッグや型チェックに役立ちます。例:
type(2) == "int" type([1]) == "list" type(struct(a = 2)) == "struct"この関数は今後変更される可能性があります。Python と互換性のあるコードを記述し、将来的な変更に対応できるようにするには、戻り値を比較する場合にのみ使用します。
if type(x) == type([]): # if x is a list
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 型を確認するオブジェクト。 |
zip
list zip(*args)
tuple
の list
を返します。i 番目のタプルには、各引数シーケンスまたはイテラブルから i 番目の要素が含まれます。リストのサイズは、最も短い入力のサイズになります。反復可能な引数を 1 つ指定すると、1 タプルのリストが返されます。引数がない場合は空のリストを返します。例:zip() # == [] zip([1, 2]) # == [(1,), (2,)] zip([1, 2], [3, 4]) # == [(1, 3), (2, 4)] zip([1, 2], [3, 4, 5]) # == [(1, 3), (2, 4)]
パラメータ
パラメータ | 説明 |
---|---|
args
|
必須 圧縮して圧縮します |