| 1 |
# find |
| 2 |
|
| 3 |
```php |
| 4 |
find ( |
| 5 |
string $selector |
| 6 |
[, int $idx = null ] |
| 7 |
[, bool $lowercase = false ] |
| 8 |
) : mixed |
| 9 |
``` |
| 10 |
|
| 11 |
| Parameter | Description |
| 12 |
| --------- | ----------- |
| 13 |
| `selector` | [](https://www.w3.org/TR/selectors/CSS](https://www.w3.org/TR/selectors/](https://www.w3.org/TR/selectors/) selector. |
| 14 |
| `idx` | Index of element to return. |
| 15 |
| `lowercase` | Matches tag names case insensitive (lowercase) if enabled. |
| 16 |
|
| 17 |
Finds one or more nodes in the current document, using CSS selectors. |
| 18 |
|
| 19 |
* Returns null if no match was found. |
| 20 |
* Returns an array of [](../simple_html_dom_node/`simple_html_dom_node`](../simple_html_dom_node/](../simple_html_dom_node/) if `$idx` is null. |
| 21 |
* Returns an object of type [](../simple_html_dom_node/`simple_html_dom_node`](../simple_html_dom_node/](../simple_html_dom_node/) if `$idx` is anything __but__ null. |
| 22 |
|
| 23 |
## Supported Selectors |
| 24 |
|
| 25 |
| Selector | Description |
| 26 |
| --------- | ----------- |
| 27 |
| `*` | [](https://www.w3.org/TR/selectors/#the-universal-selectorUniversal selector](https://www.w3.org/TR/selectors/#the-universal-selector](https://www.w3.org/TR/selectors/#the-universal-selector) |
| 28 |
| `E` | [](https://www.w3.org/TR/selectors/#type-selectorsType (tag name) selector](https://www.w3.org/TR/selectors/#type-selectors](https://www.w3.org/TR/selectors/#type-selectors) |
| 29 |
| `E#id` | [](https://www.w3.org/TR/selectors/#id-selectorsID selector](https://www.w3.org/TR/selectors/#id-selectors](https://www.w3.org/TR/selectors/#id-selectors) |
| 30 |
| `E.class` | [](https://www.w3.org/TR/selectors/#class-htmlClass selector](https://www.w3.org/TR/selectors/#class-html](https://www.w3.org/TR/selectors/#class-html) |
| 31 |
| `E[attr]` | [](https://www.w3.org/TR/selectors/#attribute-selectorsAttribute selector](https://www.w3.org/TR/selectors/#attribute-selectors](https://www.w3.org/TR/selectors/#attribute-selectors) |
| 32 |
| `E[attr="value"]` | [](https://www.w3.org/TR/selectors/#attribute-selectorsAttribute selector](https://www.w3.org/TR/selectors/#attribute-selectors](https://www.w3.org/TR/selectors/#attribute-selectors) |
| 33 |
| `E[attr="value"] i` | [](https://www.w3.org/TR/selectors/#attribute-caseCase-sensitivity](https://www.w3.org/TR/selectors/#attribute-case](https://www.w3.org/TR/selectors/#attribute-case) |
| 34 |
| `E[attr="value"] s` | [](https://www.w3.org/TR/selectors/#attribute-caseCase-sensitivity](https://www.w3.org/TR/selectors/#attribute-case](https://www.w3.org/TR/selectors/#attribute-case) |
| 35 |
| `E[attr~="value"]` | [](https://www.w3.org/TR/selectors/#attribute-selectorsAttribute selector](https://www.w3.org/TR/selectors/#attribute-selectors](https://www.w3.org/TR/selectors/#attribute-selectors) |
| 36 |
| `E[attr^="value"]` | [](https://www.w3.org/TR/selectors/#attribute-substringsSubstring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings](https://www.w3.org/TR/selectors/#attribute-substrings) |
| 37 |
| `E[attr$="value"]` | [](https://www.w3.org/TR/selectors/#attribute-substringsSubstring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings](https://www.w3.org/TR/selectors/#attribute-substrings) |
| 38 |
| `E[attr*="value"]` | [](https://www.w3.org/TR/selectors/#attribute-substringsSubstring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings](https://www.w3.org/TR/selectors/#attribute-substrings) |
| 39 |
| `E[attr|="value"]` | [](https://www.w3.org/TR/selectors/#attribute-selectorsAttribute selector](https://www.w3.org/TR/selectors/#attribute-selectors](https://www.w3.org/TR/selectors/#attribute-selectors) |
| 40 |
| `E F` | [](https://www.w3.org/TR/selectors/#descendant-combinatorsDescendant combinator](https://www.w3.org/TR/selectors/#descendant-combinators](https://www.w3.org/TR/selectors/#descendant-combinators) |
| 41 |
| `E > F` | [](https://www.w3.org/TR/selectors/#child-combinatorsChild combinator](https://www.w3.org/TR/selectors/#child-combinators](https://www.w3.org/TR/selectors/#child-combinators) |
| 42 |
| `E + F` | [](https://www.w3.org/TR/selectors/#adjacent-sibling-combinatorsNext-sibling combinator](https://www.w3.org/TR/selectors/#adjacent-sibling-combinators](https://www.w3.org/TR/selectors/#adjacent-sibling-combinators) |
| 43 |
| `E ~ F` | [](https://www.w3.org/TR/selectors/#general-sibling-combinatorsSubsequent-sibling combinator](https://www.w3.org/TR/selectors/#general-sibling-combinators](https://www.w3.org/TR/selectors/#general-sibling-combinators) |
| 44 |
| `E, F` | [](https://www.w3.org/TR/selectors/#selector-listSelector list](https://www.w3.org/TR/selectors/#selector-list](https://www.w3.org/TR/selectors/#selector-list) |
