Class: qJerry

This method is just a wrapper for 'new qJerry(...)' call.

The constructor is used to create and initialize a new qJerry object instance with passed data. The $content parameter can be a value of several types.

If the $content argument is a string and it starts with "<?xml", then try to load an XML document from it, or throw qJException on failure:

1.    $xml = '<?xml version="1.0" encoding="UTF-8"?>'."\n".
2.           '<items><item id="1"/><item id="2"/></items>';
3.  
4.    $q = new qJerry($xml);

Else, if string matches pattern "/^[a-z_][0-9a-z\-\._]*$/i", create new DOM document with the root element with specified name (useful for creating XML documents from scratch):

1.    $q = new qJerry('root-element');

Otherwise, treat string as file name or URL and try to load it (with transparent support for URL wrappers), or throw qJException on failure:

1.    $q = new qJerry('./filename.xml');
2.    $q = new qJerry('http://qjerry.com/example.xml');

If $content is the DOMDocument, then load it and set its root element as the only member of the matched set:

1.    $dom = new DOMDocument('1.0', 'UTF-8');
2.    $dom->appendChild($dom->createElement('root'));
3.    $dom->documentElement->setAttribute('name', 'Root element');
4.  
5.    $q = new qJerry($dom);

If $content is the DOMElement, then load DOM document to which specified element belongs, and set this element as the only member of the matched set:

1.    $q = new qJerry($dom->documentElement);

If $content is the DOMNodeList, then convert node list to array and set it as the matched set:

1.    $q = new qJerry($dom->getElementsByTagName('root'));

If $content is not specified, then create an empty document (userful for creating XML documents from scratch):

1.    $q = new qJerry();

If $content is of any other type, then throw a qJException.

This operation is similar to calling appendChild on all of the specified elements, adding them into the document. Optional namespace for the appended element may be provided.

Set or get values of single or multiple attributes, on all matched elements.

This set can be filtered with an optional expression that will cause only elements matching the expression to be collected. Also note: while parents() will look at all ancestors, children() will only consider immediate child elements.

This method is synonym of jQuery's clone() method, since the word 'clone' is reserved in PHP.

Change the set of matched elements to its previous state, right before the destructive operation. If there was no destructive operation before, current set is returned.

Note: jQuery's version of this method returns an empty set if there was no destructive operation before.

Important note: although the expression is tested in context of each matched element, the resulting set may contain elements from any place of the document, depending on XPath passed as an expression.

Value returned by this method highly depends on correct structure of input array. There are the basic rules:

• one array key corresponds to one DOM element
• attribute name should begin with '@' character
• value of an attribute should be of scalar type
• elements with the same name on the same level should end with suffix '~1', '~2', ...

This method is useful for processing HTML forms. In such case, the 'name' attribute of each input element of the form should follow the syntax of HTML array feature.

Example form:

1.  <form action="user.php" method="post">
2.    <input type="hidden" name="user[@id]" value="100"/>
3.    <input type="checkbox" name="user[@block]" value="no" checked="checked"/>
4.    <input type="text" name="user[login]" value="myUserName"/>
5.    <input type="password" name="user[password]" value="somePassword"/>
6.    <input type="text" name="user[group~1]" value="members"/>
7.    <input type="text" name="user[group~2]" value="bloggers"/>
8.    <input type="text" name="user[group~3]" value="admins"/>
9.    <input type="submit"/>
10.  </form>

Example form handler:

1.  <?php
2.    print_r($_POST);
3.  
4.    $q = qJerry::fromArray($_POST, 'user');
5.  
6.    $q->format()->dump();
7.  ?>

This will output:

1.    Array
2.    (
3.        [user] => Array
4.            (
5.                [@id] => 100
6.                [@block] = no
7.                [login] => myUserName
8.                [password] => somePassword
9.                [group~1] => members
10.                [group~2] => bloggers
11.                [group~3] => admins
12.            )
13.    )
14.    <?xml version="1.0" encoding="UTF-8"?>
15.    <user id="100" block="no">
16.      <login>myUserName</login>
17.      <password>somePassword</password>
18.      <group>members</group>
19.      <group>bloggers</group>
20.      <group>admins</group>
21.    </user>

There is no need to call this method directly. It allows to iterate over the matched set using foreach() loop, just like over an array of qJerry instances.

1.    foreach($q as $item)
2.      echo $item->attr('id')."\n";

This operation is, essentially, the reverse of doing a regular q(A)->after(B), in that instead of inserting B after A, you're inserting A after B.

Checks the current selection against an expression and returns true, if at least one element of the selection fits the given expression.

An optional expression to filter the result may be provided.

This operation is, essentially, the reverse of doing a regular q(A).prepend(B), in that instead of prepending B to A, you're prepending A to B.

An optional expression to filter the result may be provided.

This method is useful when writing AJAX enabled applications.

Can be filtered with an optional expression.

Attention: this is a PHP-style version of jQuery's slice() method. It relies on array_slice() function and inherits its behavior.