manifest-url
(マクロ)
パッケージ:
CURL.LANGUAGE.COMPILER
シグネチャ
{manifest-url
component-type:
String
,
name:
String
,
manifest:
ComponentManifest
=
{
get-default-manifest
},
comparison-proc:
ComponentSelector.ComparisonProc
=
ComponentSelector.prefer-first?
,
...
}:
Url
指定された属性を持つコンポーネントの URL をマニフェストで検索します。
component-type: ターゲット コンポーネントの
component-type
を指定します。
name: ターゲット コンポーネントの
name
を指定します。
manifest: 必要なコンポーネントの情報を検索する場所です。指定されていない場合は
get-default-manifest
で返されたマニフェストを使用します。
comparison-proc: 指定した属性がマニフェスト内で複数の
ComponentSelector
と一致する場合にこれを使用して結果を選択します。
...: ターゲット コンポーネントの追加の
meta-data
属性を指定するキーワード引数です。位置引数を追加するとエラーが発生します。
戻り値
マニフェスト内で一致したコンポーネントの最初の
Url
を返すか、見つからなかった場合は
ComponentLocationException
をスローします。
説明
指定された属性を持つ
ComponentSelector
を
manifest
内で探し、最初の
location-hints
を返します。複数のアイテムが見つかった場合、
comparison-proc
によって最も一致するものが選択されます。
マニフェスト内で一致するコンポーネントが見つからない場合は
ComponentLocationException
をスローします。
マニフェストを使用した詳細に関しては、『Curl 開発者ガイド』の「
マニフェスト
」を参照してください。
注意事項
リソースを配置するための代替方法については、
resource-url
、
localize-url
、
host-localize-url
を参照してください。
manifest-url
はそれらの構文より一般的なインターフェイスを提供しますが、リソース ディレクトリを検索する能力は提供しません。