ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / keebchat.com / core / libs / htmlParser / manual / docs / api / simple_html_dom_node

# find

```php
find (
    string $selector
    [, int $idx = null ]
    [, bool $lowercase = false ]
) : mixed
```

| Parameter     | Description
| ---------     | -----------
| `selector`    | [CSS](https://www.w3.org/TR/selectors/) selector.
| `idx`         | Index of element to return.
| `lowercase`   | Matches tag names case insensitive (lowercase) if enabled.

Finds one or more nodes in the current document, using CSS selectors.

* Returns null if no match was found.
* Returns an array of [`simple_html_dom_node`](../simple_html_dom_node/) if `$idx` is null.
* Returns an object of type [`simple_html_dom_node`](../simple_html_dom_node/) if `$idx` is anything __but__ null.

## Supported Selectors

| Selector              | Description
| ---------             | -----------
| `*`                   | [Universal selector](https://www.w3.org/TR/selectors/#the-universal-selector)
| `E`                   | [Type (tag name) selector](https://www.w3.org/TR/selectors/#type-selectors)
| `E#id`                | [ID selector](https://www.w3.org/TR/selectors/#id-selectors)
| `E.class`             | [Class selector](https://www.w3.org/TR/selectors/#class-html)
| `E[attr]`             | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)
| `E[attr="value"]`     | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)
| `E[attr="value"] i`   | [Case-sensitivity](https://www.w3.org/TR/selectors/#attribute-case)
| `E[attr="value"] s`   | [Case-sensitivity](https://www.w3.org/TR/selectors/#attribute-case)
| `E[attr~="value"]`    | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)
| `E[attr^="value"]`    | [Substring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings)
| `E[attr$="value"]`    | [Substring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings)
| `E[attr*="value"]`    | [Substring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings)
| `E[attr|="value"]`    | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)
| `E F`                 | [Descendant combinator](https://www.w3.org/TR/selectors/#descendant-combinators)
| `E > F`               | [Child combinator](https://www.w3.org/TR/selectors/#child-combinators)
| `E + F`               | [Next-sibling combinator](https://www.w3.org/TR/selectors/#adjacent-sibling-combinators)
| `E ~ F`               | [Subsequent-sibling combinator](https://www.w3.org/TR/selectors/#general-sibling-combinators)
| `E, F`                | [Selector list](https://www.w3.org/TR/selectors/#selector-list)

[-] childNodes.md [edit]
[-] innertext.md [edit]
[-] xmltext.md [edit]
[-] firstChild.md [edit]
[-] setAttribute.md [edit]
[-] removeClass.md [edit]
[-] removeAttribute.md [edit]
[+] ..
[-] __unset.md [edit]
[-] text.md [edit]
[-] convert_text.md [edit]
[-] lastChild.md [edit]
[-] clear.md [edit]
[-] is_utf8.md [edit]
[-] prevSibling.md [edit]
[-] removeChild.md [edit]
[-] getElementById.md [edit]
[-] get_display_size.md [edit]
[-] parentNode.md [edit]
[-] outertext.md [edit]
[-] getElementsById.md [edit]
[-] __get.md [edit]
[-] dump.md [edit]
[-] addClass.md [edit]
[-] getAllAttributes.md [edit]
[-] __isset.md [edit]
[-] parse_selector.md [edit]
[-] getElementByTagName.md [edit]
[-] match.md [edit]
[-] seek.md [edit]
[-] __destruct.md [edit]
[-] hasAttribute.md [edit]
[-] prev_sibling.md [edit]
[-] find_ancestor_tag.md [edit]
[-] __construct.md [edit]
[-] next_sibling.md [edit]
[-] parent.md [edit]
[-] nextSibling.md [edit]
[-] getElementsByTagName.md [edit]
[-] hasChildNodes.md [edit]
[-] simple_html_dom_node.md [edit]
[-] getAttribute.md [edit]
[-] dump_node.md [edit]
[-] makeup.md [edit]
[-] last_child.md [edit]
[-] __set.md [edit]
[-] appendChild.md [edit]
[-] has_child.md [edit]
[-] nodeName.md [edit]
[-] first_child.md [edit]
[-] children.md [edit]
[-] find.md [edit]
[-] save.md [edit]
[-] __toString.md [edit]
[-] remove.md [edit]
[-] hasClass.md [edit]