<?xml version="1.0" encoding="UTF-8" ?>
<dt-option group="option">
	<name>destroy</name>
	<summary>Destroy any existing table matching the selector and replace with the new options.</summary>
	<since>1.10</since>

	<type type="boolean" />
	<default value="false" />

	<description>
		Initialise a new DataTable as usual, but if there is an existing DataTable which matches the selector, it will be destroyed and replaced with the new table. This can be useful if you want to change a property of the table which cannot be altered through the API.

		Note that if you are not changing the configuration of the table, but just altering the data displayed by the table, it is far more efficient to use the `dt-api ajax.reload()` method (or `dt-api rows.add()` etc).
	</description>


	<example title="Destroy an exisiting table and create a new one"><![CDATA[
$('#example').dataTable( {
  "srollY": "200px"
} );

// Some time later, recreate with just filtering (no scrolling)
$('#example').dataTable( {
  "filter": false,
  "destroy": true
} );
]]></example>

	<related type="init">retrieve</related>
	<related type="api">destroy</related>
	<related type="api">ajax.reload()</related>
	<related type="event">destroy</related>
</dt-option>