====DROP====

===Parameters===

^Order^Name^Type^Desc^
|1|haystack|pointlist|The point list to remove items from|
|2|needle|varies|The item to remove|

===Returns===

This searches the //haystack// list of points for the //needle// and removes it.

===Description===

This function is used to remove results you don't want from your query. It's commonly used along-side functions like [[fALLPOINTS]] and [[fAIPOINTS]] to remove properties or assets you aren't particularly interested in.

The //needle// parameter can be a list of **assets**, **properties** or **points**. All points that match will be removed.

===Example===

If you had the following //haystack// point list...

^Haystack Content^
|Main Machine.Temperature|
|Main Machine.Status|
|Main Machine.Daily Total|
|Sub-Part.Vibration|
|Sub-Part.Temperature|
|Sub-Part.Daily Total|

The queries below would be useful...

<code>
'Daily Total' PROPERTY DROP
</code>
//This would remove both of the 'Daily Total' properties.'//

<code>
'Sub-Part' ASSET DROP
</code>
//This would remove both **Sub-Part** properties.//

<code>
'Sub-Part' ASSET 'Temperature' PROPERTY VALUES DROP
</code>
//Would specifically remove the **Sub-Part Temperature** property, but leave the vibration property in place.//

===See Also===

[[fAIPOINTS]] \\
[[fALLPOINTS]] \\