このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
psr:psr13 [2020/07/20 08:27] y2sunlight [3.2 Psr\Link\EvolvableLinkInterface] |
psr:psr13 [2020/09/01 11:53] (現在) tanaka [PSR-13: Link definition interfaces] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | > 編集中 | ||
- | |||
====== PSR-13: Link definition interfaces ====== | ====== PSR-13: Link definition interfaces ====== | ||
--- // | --- // | ||
- | 本章は、若干の補足を加筆してはいるものの単に[[https:// | + | 本章は、若干の補足を加筆してはいるものの単に[[https:// |
関連記事 | 関連記事 | ||
行 20: | 行 18: | ||
* PSR-13: Link definition interfaces - リンク定義インターフェース | * PSR-13: Link definition interfaces - リンク定義インターフェース | ||
* [[psr: | * [[psr: | ||
- | * [[psr: | + | * [[psr: |
+ | * [[psr: | ||
+ | * [[psr: | ||
+ | * [[psr: | ||
+ | * [[psr: | ||
----- | ----- | ||
行 278: | 行 280: | ||
/** | /** | ||
- | * A link provider object. | ||
* リンクプロバイダーオブジェクト | * リンクプロバイダーオブジェクト | ||
*/ | */ | ||
行 284: | 行 285: | ||
{ | { | ||
/** | /** | ||
- | * Returns an iterable of LinkInterface objects. | ||
* LinkInterfaceオブジェクトのiterableを返します。 | * LinkInterfaceオブジェクトのiterableを返します。 | ||
* | * | ||
- | * The iterable may be an array or any PHP \Traversable object. If no links | + | * iterableは、配列または任意のPHP \Traversableオブジェクトです。利用可能なリンクがない場合は、 |
- | * are available, an empty array or \Traversable MUST be returned. | + | * 空の配列 または \Traversableを返す必要があります( MUST )。 |
- | * iterableは、配列または任意のPHP \Traversableオブジェクトです。 利用可能なリンクがない場合は、 | + | |
- | * 空の配列または\ Traversableを返す必要があります( MUST )。 | + | |
* | * | ||
* @return LinkInterface[]|\Traversable | * @return LinkInterface[]|\Traversable | ||
行 297: | 行 295: | ||
/** | /** | ||
- | * Returns an iterable of LinkInterface objects that have a specific relationship. | ||
* 特定の関係を持つLinkInterfaceオブジェクトのiterableを返します。 | * 特定の関係を持つLinkInterfaceオブジェクトのiterableを返します。 | ||
* | * | ||
- | * The iterable may be an array or any PHP \Traversable object. If no links | + | * iterableは、配列または任意の PHP \Traversableオブジェクトです。その関係を持つリンクがない場合は、 |
- | * with that relationship are available, an empty array or \Traversable MUST be returned. | + | |
- | * iterableは、配列または任意のPHP \Traversableオブジェクトです。 その関係を持つリンクがない | + | |
- | | + | |
* | * | ||
* @return LinkInterface[]|\Traversable | * @return LinkInterface[]|\Traversable | ||
行 321: | 行 316: | ||
/** | /** | ||
- | | + | |
- | * 発展的リンクプロバイダー値オブジェクト | + | |
*/ | */ | ||
interface EvolvableLinkProviderInterface extends LinkProviderInterface | interface EvolvableLinkProviderInterface extends LinkProviderInterface | ||
{ | { | ||
/** | /** | ||
- | * Returns an instance with the specified link included. | ||
* 指定されたリンクを含むインスタンスを返します。 | * 指定されたリンクを含むインスタンスを返します。 | ||
* | * | ||
- | * If the specified link is already present, this method MUST return normally | ||
- | * without errors. The link is present if $link is === identical to a link | ||
- | * object already in the collection. | ||
* 指定されたリンクがすでに存在する場合、このメソッドはエラーなしで正常に戻る必要があります。 | * 指定されたリンクがすでに存在する場合、このメソッドはエラーなしで正常に戻る必要があります。 | ||
- | * $linkが===既にコレクションにあるリンクオブジェクトと同一である場合、リンクは存在します。 | + | * $linkが既にコレクションにあるリンクオブジェクトと同一( '' |
* | * | ||
* @param LinkInterface $link | * @param LinkInterface $link | ||
- | | ||
| | ||
* @return static | * @return static | ||
行 344: | 行 333: | ||
/** | /** | ||
- | * Returns an instance with the specified link removed. | ||
* 指定されたリンクが削除されたインスタンスを返します。 | * 指定されたリンクが削除されたインスタンスを返します。 | ||
* | * | ||
- | * If the specified link is not present, this method MUST return normally | ||
- | * without errors. The link is present if $link is === identical to a link | ||
- | * object already in the collection. | ||
* 指定されたリンクが存在しない場合、このメソッドはエラーなしで正常に戻る必要があります。 | * 指定されたリンクが存在しない場合、このメソッドはエラーなしで正常に戻る必要があります。 | ||
- | * $linkが===既にコレクションにあるリンクオブジェクトと同一である場合、リンクは存在します。 | + | * $linkが既にコレクションにあるリンクオブジェクトと同一( '' |
* | * | ||
* @param LinkInterface $link | * @param LinkInterface $link | ||
- | | ||
| | ||
* @return static | * @return static |