ジェネレーター オブジェクト (ジェネレーター)

このオブジェクトは generator() によって返され、ファイルを一種類から別の一種類に変換するために実行可能ファイル (例: idl ファイルからソースコードおよびヘッダー) で使用されるジェネレーターが含まれます。

によって返される

ジェネレーター オブジェクト オブジェクトは、以下の関数とメソッドによって返されます。

ジェネレーター オブジェクト メソッド

generator.process()

ファイルのリストを取り込んで処理し、結果を含むオブジェクトを返します。これはビルドターゲット定義に引き渡すことができます。

シグネチャ

# Takes a list of files, causes them to be processed and returns an object containing the result
generated_list process(
  str | file | custom_tgt | custom_idx | generated_list source...,  # List of sources to process

  # Keyword arguments:
  env                : env | list[str] | dict[str]  # environment variables to set, such as
  extra_args         : list[str]                    # If present, will be used to replace an entry `@EXTRA_ARGS@` in the argument list
  preserve_path_from : str                          # If given, specifies that the output files need to maintain their directory structure
)

引数

このメソッドは、1 から 無限 の可変長引数 (source...) を str | file | custom_tgt | custom_idx | generated_list の型で受け入れます。

処理するソースのリストです。

このメソッド generator.process() は以下のキーワード引数を受け入れます。

名前 種類 説明 タグ
env env | list[str] | dict[str]

設定する環境変数。例: {'NAME1': 'value1', 'NAME2': 'value2'} または ['NAME1=value1', 'NAME2=value2']。または env オブジェクトで、高度な環境の操作が可能です。

(バージョン 1.3.0 以降)
extra_args list[str]

存在する場合、引数リストの @EXTRA_ARGS@ エントリを置き換えるために使用されます。
preserve_path_from str

指定された場合、出力ファイルはターゲット一時ディレクトリ内でディレクトリ構造を維持する必要があることを示します。この最も一般的な値は meson.current_source_dir() です。この値を使用すると、subdir/one.input というファイルが処理されると、{ターゲットプライベートディレクトリ}/one.out ではなく、{ターゲットプライベートディレクトリ}/subdir/one.out というファイルが生成されます。

(バージョン 0.45.0 以降)

検索結果は