"deleteLine"

Deletes a row if certain conditions are met.

Synopsis

setValue(string shape, "deleteLine", int n, string Name1, <type1> Value1 [, string Name2, <type2> Value2 ...]);

shape.deleteLine(int n, string Name1, <type1> Value1);

Parameters

Parameter Description
shape Name of the object
n Number of conditions
Name1 Column name
Value1 Key

Description

This attribute deletes the topmost row in a table provided certain conditions have been met. Each row in the column "Name" will be checked to see whether its contents match the associated key "Value";. Several conditions can be stipulated here with the number of conditions defined by the variable n. If all n conditions have been met, the corresponding row will be deleted. If there is no row matching the conditions, then sending the attribute has no effect.

Example

The following example deletes the first row containing the value "Peter"; in the column "Forename" and the value "Baker" in the column "Surname";.

 main()
{
  table.deleteLine(2, "Forename", "Peter", "Surname", "Baker");
}

Assignment

Table