Difference between revisions of "Tab.Compare"
m (1 revision imported) |
|||
| Line 4: | Line 4: | ||
|caption=Сравнение таблиц | |caption=Сравнение таблиц | ||
|type=1 | |type=1 | ||
| − | |status= | + | |status=2 |
|db=0 | |db=0 | ||
|exception=невозможно превратить в строку, неверный аргумент | |exception=невозможно превратить в строку, неверный аргумент | ||
| Line 17: | Line 17: | ||
== Синтаксис == | == Синтаксис == | ||
<code> | <code> | ||
| − | {{Grey|Tab.}}'''Compare'''(''<Таблица для сравнения (TAB)>''{{Optional|,< | + | {{Grey|Tab.}}'''Compare'''(''<Таблица для сравнения (TAB)>''{{Optional|,<Столбцы для сравнения (STRING)>}}):''<Сравниваемая таблица совпадает с текущей (INT)>'' |
</code> | </code> | ||
==== Аргументы ==== | ==== Аргументы ==== | ||
* <code>''<Таблица для сравнения (TAB)>''</code> - Таблица, с которой будет происходит сравнение текущей таблицы. | * <code>''<Таблица для сравнения (TAB)>''</code> - Таблица, с которой будет происходит сравнение текущей таблицы. | ||
| − | * <code>''< | + | * <code>''<Столбцы для сравнения (STRING)>''</code> - {{Optional}} Аргумент содержит список наименований столбцов, которые будут использоваться при сравнении. Наименования разделены запятыми. Если аргумент не задан, будут сравниваться все столбцы, при этом порядок столбцов первой и второй таблицы должен совпадать, иначе функция возвратит 0. Если аргумент задан, будут сравниваться только указанные столбцы, при этом порядок следования столбцов в первой и второй таблицах не будет проверяться на совпадение. |
==== Возвращаемое значение ==== | ==== Возвращаемое значение ==== | ||
Revision as of 10:22, 21 February 2021
| Compare (Сравнение таблиц) | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
Функция сравнивает текущую таблицу с заданной по указанным правилам, и возвращает 1, если таблицы эквивалентны. Функция проверяет, что количество столбцов, их порядок, их наименования, порядок строк и каждая ячейка в каждой строке одной таблицы соответствует второй.
Синтаксис
Tab.Compare(<Таблица для сравнения (TAB)>,<Столбцы для сравнения (STRING)>):<Сравниваемая таблица совпадает с текущей (INT)>
Аргументы
<Таблица для сравнения (TAB)>- Таблица, с которой будет происходит сравнение текущей таблицы.<Столбцы для сравнения (STRING)>- (необязательный аргумент) Аргумент содержит список наименований столбцов, которые будут использоваться при сравнении. Наименования разделены запятыми. Если аргумент не задан, будут сравниваться все столбцы, при этом порядок столбцов первой и второй таблицы должен совпадать, иначе функция возвратит 0. Если аргумент задан, будут сравниваться только указанные столбцы, при этом порядок следования столбцов в первой и второй таблицах не будет проверяться на совпадение.
Возвращаемое значение
Возвращает 1, если таблицы совпадают с точки зрения режима сравнения функции, 0 -- в ином случае.
Примеры
//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");
aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);
//Создаем копию текущей таблицы
bTab:=aTab.Copy();
Message("Таблицы aTab и bTab "+?(aTab.Compare(bTab),"совпадают","не совпадают"));
//Будет выведено "Таблицы aTab и bTab совпадают"
//Сдвигаем строку 1 таблицы bTab на две строки вниз.
bTab.Move(1,2);
Message("Таблицы aTab и bTab "+?(aTab.Compare(bTab),"совпадают","не совпадают"));
//Будет выведено "Таблицы aTab и bTab не совпадают"
