ライブラリターゲット（libはbuild_tgtを拡張）

共有ライブラリまたは静的ライブラリのいずれかを表します。

拡張元

ライブラリターゲットは、以下のサブタイプによって拡張されます。

• both_libs

返却元

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

• library()
• shared_library()
• static_library()
• both_libs.get_shared_lib()
• both_libs.get_static_lib()

継承されたメソッド

build_tgt.extract_all_objects()

extract_objectsと同じように動作しますが、このターゲットによって生成されたすべてのオブジェクトファイルを返します。

デフォルトでは、以前のバージョンとの下位互換性を維持するために、このターゲット用にビルドされたオブジェクトのみが返されます。recursiveキーワード引数のデフォルト値は、将来のバージョンでtrueに変更される予定です。

# Acts the same as `extract_objects`, but returns all object files generated
extracted_obj extract_all_objects(
  recursive : bool  # Also return objects passed to the `objects` argument of this target
)

引数

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

名前	型	説明	タグ
recursive	bool	このターゲットのobjects引数に渡されたオブジェクトも返します。	(0.46.0以降) デフォルト = true

---

build_tgt.extract_objects()

それらのソースファイルに対して生成されたオブジェクトファイルを表現する不透明な値を返します。これは通常、単一のオブジェクトファイルを取得してユニットテストにリンクしたり、カスタムフラグを使用していくつかのソースファイルをコンパイルするために使用されます。別のビルドターゲットでオブジェクトファイルを使用するには、build_target()またはdeclare_dependency()のobjects:キーワード引数を使用するか、custom_target()のコマンドラインに含めます。

# Returns an opaque value representing the object files generated for those
extracted_obj extract_objects(
  str | file source...,  # Source filenames for which the built objects should be extracted
)

引数

このメソッドは、1からinfinityまでの可変長引数（source...）をstr | file型で受け入れます。

ビルドされたオブジェクトを抽出するソースファイル名。

---

build_tgt.found()

常にtrueを返します。この関数は、実行可能ファイルオブジェクトをexternal_programオブジェクトと機能的に互換性を持たせることを目的としています。これにより、実行可能ファイルがexternal_programの代わりに使用されるユースケースが簡素化されます。

bool found()

---

build_tgt.full_path()

結果のターゲットファイルへのフルパスを返します。**注意:**ほとんどの場合、オブジェクト自体を使用することでこれと同じことができ、Mesonがターゲット間の依存関係を正しく設定することもできます。それがうまくいかない場合は、バグを報告してください。

str full_path()

---

build_tgt.name()

ターゲットの名前を返します。

str name()

---

build_tgt.path()

build_tgt.full_path()とまったく同じことを行います。**注意:**この関数は、external_programオブジェクトとの互換性のためにのみ保持されています。external_programオブジェクト内の、廃止予定の対応するpath()関数が削除されたら、これも削除されます。

str path()

---

build_tgt.private_dir_include()

include_directories()のように動作しますが、このターゲットのプライベートディレクトリを指す値を返します。通常、別のターゲットがこのターゲットの生成された内部ヘッダーにアクセスする必要がある場合にのみ必要です。

inc private_dir_include()

---