More docs for selectors.

Author: Smoren

src/Selectors/IndexListSelector.php

@@ -11,6 +11,16 @@
 
 /**
  * Represents an index list selector that selects elements based on the provided array of indexes.
+ *
+ * ##### Example
+ * ```php
+ * $originalArray = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+ * $view = ArrayView::toView($originalArray);
+ *
+ * $selector = new IndexListSelector([0, 2, 4]);
+ * print_r($view[$selector]); // [1, 3, 5]
+ * print_r($view->subview($selector)->toArray()); // [1, 3, 5]
+ * ```
  */
 final class IndexListSelector implements IndexListSelectorInterface
 {

src/Selectors/MaskSelector.php

@@ -10,6 +10,16 @@
 
 /**
  * Represents a mask selector that selects elements based on the provided array of boolean mask values.
+ *
+ * ##### Example
+ * ```php
+ * $originalArray = [1, 2, 3, 4, 5];
+ * $view = ArrayView::toView($originalArray);
+ *
+ * $selector = new MaskSelector([true, false, true, false, true]);
+ * print_r($view[$selector]); // [1, 3, 5]
+ * print_r($view->subview($selector)->toArray()); // [1, 3, 5]
+ * ```
  */
 class MaskSelector implements MaskSelectorInterface
 {

src/Selectors/SliceSelector.php

@@ -11,6 +11,32 @@
 
 /**
  * Represents a slice selector that selects elements based on the provided slice parameters.
+ *
+ * ##### Example
+ *  ```php
+ * $originalArray = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+ * $view = ArrayView::toView($originalArray);
+ *
+ * $selector = new SliceSelector('::2');
+ * print_r($view[$selector]); // [1, 3, 5, 7, 9]
+ * print_r($view->subview($selector)->toArray()); // [1, 3, 5, 7, 9]
+ *
+ * $selector = new SliceSelector('1::2');
+ * print_r($view[$selector]); // [2, 4, 6, 8, 10]
+ * print_r($view->subview($selector)->toArray()); // [2, 4, 6, 8, 10]
+ *
+ * $selector = new SliceSelector('-3::-2');
+ * print_r($view[$selector]); // [8, 6, 4, 2]
+ * print_r($view->subview($selector)->toArray()); // [8, 6, 4, 2]
+ *
+ * $selector = new SliceSelector('1:4');
+ * print_r($view[$selector]); // [2, 3, 4]
+ * print_r($view->subview($selector)->toArray()); // [2, 3, 4]
+ *
+ * $selector = new SliceSelector('-2:0:-1');
+ * print_r($view[$selector]); // [9, 8, 7, 6, 5, 4, 3, 2]
+ * print_r($view->subview($selector)->toArray()); // [9, 8, 7, 6, 5, 4, 3, 2]
+ * ```
  */
 class SliceSelector extends Slice implements ArraySelectorInterface
 {