Модуль сереализации/десереализации и печати таблиц Lua

Автор записи: TGB

Сереализация таблицы Lua (со всеми ее, возможно, многоуровневыми вложенностями и перекрестными ссылками) это представление ее в виде строки. Десереализация это обратная операция – восстановление таблицы из строки.

Эти операции могут потребоваться, например, при хранении таблиц на внешнем накопителе или при передачи таблиц между различными скриптами.

Особенность представленного модуля состоит в том, что на вид сереализуемых/десереализуемых таблиц накладываются более слабые ограничения, чем это обычно принято.

--

В модуле реализовано два варианта сереализации/десереализации таблиц Lua:

1) Сереализация/десереализация (функции tbl_to_string и string_to_tbl) таблиц частного вида со следующими ограничениями:

- ключи и поля таблицы только типа : table (простые, не метатаблицы), booleannumberstring;

- все внутренние элементы таблицы (ключи и поля) типа table (ссылки на них) должны быть уникальными (в пределах таблицы с учетом всех ее вложенностей).

2) Сереализация/десереализация (функции tbl_to_str  и str_to_tb ) таблиц общего вида (при условиях,  детально рассмотренных далее в описании модуля), элементами (ключами и полями) которых могут быть любые Lua-типы (включая метатаблицы и ссылки на functionthread, userdata). Связи между элементами таблиц могут быть произвольными.

Кроме того, в модуле реализована функция печати любых Lua-данных, в том числе произвольных таблиц в удобном для анализа виде (со всеми вложенностями и перекрестными связями, включая метатаблицы, а также ссылки на functionthread, userdata).

----

В представленном скрипте-тесте выполняется сереализация/десереализация глобальной таблицы Lua _G, хранящей стандартные и подключаемые пакеты скрипта, все его переменные без спецификации local и т.д. Там же приведены примеры  сереализации/десереализации более простых таблиц, например:

local t1 = {5, 't1'}

local tbl_str = {1, 2

, { 3, 4, {5}, [t1] = '[t1]' }

, [ { {}, '[8]' } ] = {'Простой пример'}

}

------------------------------------------------------

Реализовать сереализацию/десереализацию таблиц частного вида просто.

Реализация сереализация/десереализация таблиц общего вида это более сложный вариант. Ниже приводится краткое описание такой реализации.

В функции сереализации таблиц общего вида выполняется рекурсивный проход по всем элементам таблицы с ключами и полями произвольного lua-типа. При этом создается код Lua-скрипта (в виде текста скрипта или байт-кода), выполнение которого, с использованием данных, созданных для него, обеспечивает полное восстановление любой сереализованной таблицы в выполняемом скрипте или при его перезапуске.

Функция десереализации таблиц запускает сформированный при сереализации Lua-код, полностью восстанавливающий (с учетом всех вложенностей таблицы произвольного вида) все элементы типа booleannumberstringtable (в том числе метатаблицы).  Кроме того эта функция, используя данные сереализации, восстанавливает также ссылочные элементы таблицы типа functionthread и userdata.

  Существенным условием возможности восстановления в предложенном модуле ссылочных элементов таблицы явлается: десереализация в том же контексте (это понятие определено далее), в котором была выполнена сереализация. При отсутствии в таблице ссылочных элементов, никаких ограничений на выполнение десереализации нет.

---

  В эффективности выполнения функций сереализации/десереализации таблиц общего вида можно убедиться, запуская на исполнение приведенный в статье пример сереализации/десереализации глобальной таблицы Lua _GВ моем случае тестирования модуля в «песочнице» QUIK,  сереализация  _G (при распечатывании всех ее вложенностей это ~360 строк) выполняется за ~2 млсек., а десереализация за ~1 млсек. Длительность выполнения операций сереализации/десереализации в модуле пропорциональна размеру обрабатываемых таблиц и, практически, не зависит от степени их сложности.

-----

Описание модуля

В подавляющем большинстве случаев применения сереализации/десереализации таблиц, функциональности простых функций tbl_to_string и string_to_tbl, наверное, достаточно.

---

Во всех случаях применения простых функций, их можно заменить, без потери простоты использования и эффективности, на более общие функции tbl_to_str  и str_to_tblВ области общей применимости, некоторым преимуществом простых функций, является представление строкой – результатом функции tbl_to_string сереализованной таблицы в наглядной, скобочной форме конструктора таблиц Lua. Но не все таблицы без ссылочных данных могут быть обработаны простыми функциями (ограничение на вид допустимых таблиц было описано ранее). Общие функции могут обрабатывать любые такие таблицы.

---

При использовании tbl_to_str  и str_to_tbl для сереализации/десереализации таблиц  со ссылочными данными, важным понятием является контекст выполнения сереализации/десереализации таблиц.

Под контекстом выполнения сереализации/десереализации функций tbl_to_str  и str_to_tbl понимается список доступных им, в момент их выполнения, ссылочных данных (functionthread и userdata), на которые есть ссылки из сереализуемой таблицы и из переменных скрипта вне этой таблицы. Если упрощенно: десереализация должна выполняться в том скрипте (возможно, перезапущенном), в котором была выполнена сереализация. Из ранее сказанного следует, что, если в сереализуемой таблице есть ссылочное данное, на которое нет ссылок из других, доступных скрипту, переменных, то это данное, при десереализации, восстановить нельзя. Но зная об этом, избежать такой ситуации можно, специально создавая в скрипте ссылки в переменных(или таблицах), внешних  относительно сереализуемой таблицы.

В простом варианте контекстом может быть любая таблица, внешняя по отношению к сереализируемой, внутри которой, на любом ее уровне вложенности, хранятся ссылки на ссылочные данные, на которые есть ссылки и из сереализируемой таблицы. Для более сложных случаев можно использовать функцию формирования контекста сереализаци/десереализаци creating_link_tables.

В модуле контекстом по умолчанию (изменяемым при необходимости) является таблица, ссылка на которую хранится в _ENV (переменная окружения скрипта для версий Lua >= 5.2), с добавлением к этой таблицы области всех локальных переменных скрипта, видимых в месте сереализации/десереализации таблицы.

---

Параметры и результаты всех функций модуля описаны в комментариях их кодов. При этом в квадратных скобках указаны необязательные параметры, задания которых в типичных случаях не требуется.

-----------

Использование функций сереализации/десереализации таблиц Lua общего вида

В простом варианте восстановления сереализованной таблицы после перезапуска скрипта, когда контекст ее десереализации не отличается от контекста ее сереализации (в коде перезапускаемого скрипта нет изменений , либо эти изменения не затрагивают контекст десереализации), все просто.

-- Сереализация  таблицы --

< Строка образа таблицы >  = tbl_to_str (<Таблица> [, <Формат образа таблицы> [ ,<Контекст сереализации>]])

Где:

<Строка образа таблицы> - если же 2-ой параметр путь файла, то запись строки в файл;

<Формат образа таблицы> - путь файла сохранения образа (в виде строки) или вид результата (0 | 1 - строка-скрипт или байт-код);

<Контекст сереализации> - таблица контекста работающего скрипта (например, _G).

-- !! Далее может быть перезапуск скрипта  --

-- Восстановление таблицы --

<Таблица> = str_to_tbl (<Сохраненный где то образ - результат функции tbl_to_str > [,<Контекст сереализации>])

--

Более сложный вариант использования модуля (при отличии контекста восстановления таблицы от контекста ее сереализации)  в некоторых случаях возможен, но в статье не описывается.

------------------------------------------------

Далее приведены код модуля сереализации/десереализации таблиц Lua и код скрипта , тестирующий этот модуль .  Для подключения модуля к коду теста, достаточно поместить файл кода модуля (под именем файла: table_serialization_all.lua) в папку хранения кода запуска КВИКа: info.exe.  По ссылке: https://cloud.mail.ru/public/W7E8/uR8ik7X9Z   лежат коды.

Скрытый текст
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
---- Модуль сереализация (с сылочными данными) ----
----------------------------------
----------------------------------
--- Вывод любых данных Lua. В том числе любых таблиц, в виде таблицы-массива строк (либо в виде строки) ------
------ Параметры:
-- 1) t - любой тип; если таблица, то выводятся все вложения до значения параметра limit;
-- 2) i - начальная строка формирования отступа при выводе вложений (например, ' ')
---- 3) limit - уровень вложенности до которого просматривается таблица (если = 0, то все уровни)-----
---- 4) pr - (не обязательный) &lt;Вид выдачи результата: 0 (по умолчанию)– строка (образ таблицы); 1 - таблица-массив строк образа таблицы&gt;
---- 5) list - (не обязательный) &lt;Таблица имен элементов (задаваемых в ключах) , не разворачиваемых далее &gt;
--- ! Результат (если t - таблица): таблица-массив строк или строка, в зависимости от параметра pr.
--- Элемент результата вывода таблицы: заголовок таблицы. Остальные элементы - строковые представления структуры таблицы t
--- с дополнительными служебными описаниями вложенных в t таблиц.
local function dump_tbl(t, i, limit, pr, list)
 if type(t) ~= 'table' or i == nil then
 return 'Тип ' .. type(t) .. ': ' .. tostring(t)
 end
 
 list = list or {}
 if type(list) ~= 'table' then
 return nil, '! Ошибка. Параметр list не таблица'
 end
 pr = pr or 0
 limit = limit or 0
 local tbl = {}; --- для сбора результата ----
 tbl[#tbl + 1] = '===== Таблица (текстовая сортировка по возрастанию индексов таблиц): ' .. tostring(t)
 .. ' \n ! Количество выводимых уровней вложенности (если = 0, то выводятся все) = ' .. limit .. '\n'
 local seen={} -- просмотренные --
 local Level = 0
 ---------------------------------
 local function dump(t,i, nm)
 nm = nm or 'T'
 if seen[t] then
 return seen[t]
 end
 ------
 seen[t] = nm
 local t_v, t_k, nm_tm, v_tm
 Level = Level + 1 --- Уровень вложенности таблицы ----
 
 --- Обработка метатаблицы ----
 local mt = debug.getmetatable(t)
 if mt then
 nm_tm = seen[mt]
 if nm_tm then
 tbl[#tbl + 1] = i .. 'У таблицы ' .. nm .. ' есть существующая метатаблица -&gt; ' .. nm_tm .. '\n'
 else
 nm_tm = tostring(mt)
 tbl[#tbl + 1] = i .. 'Вложенность: ' .. Level .. ' === Содержимое метатаблицы ### : ' .. nm_tm .. '\n'
 dump(mt, i..'\t', nm_tm)
 tbl[#tbl +1] = i .. 'Вложенность: ' .. Level .. ' === Конец метатаблицы ## ' .. nm_tm .. '\n'
 end
 end
 ---------------------------------
 if next(t) == nil then ---- Таблица пустая ---
 tbl[#tbl + 1] = i .. 'Вложенность: ' .. Level .. ' Таблица: ' .. nm .. ' пустая ### '.. '\n'
 Level = Level - 1
 return ''
 end
 
 local s={} --- массив хранение имен ключей (строк) для сортировки ---
 local ss={} -- массив для хранения самих ключей --
 local n=0
 local ks=0
 for k, v in next, t do
 ks = tostring(k)
 n=n+1
 s[n] = ks
 ss[ks] = k
 end
 table.sort(s)
 
 for k,v in ipairs(s) do --- s - таблица-массив ---
 t_k = ss [v] -- ключ записи в t, v - имя ключа (tostring(t_k)) --
 t_v = t [t_k] -- значение записи в t --
 
 if Level &lt; (limit + 2) or limit == 0 then
 --- Обработка ключа ---
 v_tm = '[' .. v .. '] ('
 if type(t_k) == 'table' then --- Обработка ключа-таблицы ---
 nm_tm = seen[t_k]
 if nm_tm then
 v_tm = '[' .. tostring(t_k) .. ' - cсылка на существующую таблицу-ключ -&gt; ' .. nm_tm .. '] (' -- !! будет вместо v_tm
 else
 tbl[#tbl + 1] = i .. 'Вложенность: ' .. Level .. ' === Содержимое ключа-таблица $$ : ' .. v .. '\n'
 dump(t_k, i..'\t', tostring(t_k))
 tbl[#tbl + 1] = i .. 'Вложенность: ' .. Level .. ' === Конец ключа-таблицы $$ ' .. v .. '\n'
 end
 end
 ----- Обработка поля -----
 if type(t_v) == 'table' then --- Обработка поля-таблицы ----
 nm_tm = seen[t_v]
 if nm_tm then -- таблица уже обработана ---
 tbl[#tbl + 1] = i .. v_tm .. type(t_v) .. ') = ' .. tostring(t_v) .. ' ссылка на существующую таблицу -&gt; ' .. nm_tm .. '\n'
 else
 if list[v] then
 tbl[#tbl + 1] = i .. v_tm .. type(t_v) .. ') = ' .. tostring(t_v) .. ' | Терминальная таблица (в печати задано далее не разворачивать) ### \n'
 else
 tbl[#tbl + 1] = i .. v_tm .. type(t_v) .. ') = ' .. tostring(t_v) .. '\n'
 tbl[#tbl + 1] = i .. 'Вложенность: ' .. Level .. ' === Содержимое таблицы : ' .. v .. '\n'
 dump(t_v, i..'\t', tostring(t_k))
 tbl[#tbl + 1] = i .. 'Вложенность: ' .. Level .. ' === Конец таблицы ' .. v .. '\n'
 end
 end
 else
 tbl[#tbl + 1] = i .. v_tm .. type(t_v) .. ') = ' .. tostring(t_v) .. '\n'
 end
 -----------------------------
 end
 end
 Level = Level - 1
 return ''
 end
 --------------
 dump(t, i, tostring(t))
 if pr == 1 then --- Выдача результата в виде массива строк ---
 return tbl
 else return table.concat(tbl) --- Выдача результата в виде строки ---
 end
end
 
 -------------- Общие данные модуля сереализации --------------
--- 1. Для выделения строк используется скобки [[ ]] и поэтому внутри них не надо никаких преобразований (типа замены \ на \\ и т.д).
-- 2. В выдаваемых стоках для удобства анализа, места, на которые надо обращать внимание в первую очередь, выделены символом ###.
----
local load_Lua = load
local tbl_cont_default = _ENV --- Таблица контекста сереализации по умолчанию ---
if _VERSION == "Lua 5.1" then
 load_Lua = loadstring
 tbl_cont_default = _G
end
local tbl_cont_result --- Таблица контекста сереализации (результат) ---
----------- Таблицы связи с ссылочными данными контекста --
local aliases_cont = { } --- Записи таблицы: [&lt;Внутреннее имя ссылочного данного (формируемое функцией tostring)&gt;]
 --- = &lt;Внешнее имя ссылочного данного в контексте (в виде '###: CONT.&lt;Имя1&gt;.&lt;Имя2&gt;....)&gt;
local aliases_v_cont = { } --- Записи таблицы: [&lt;Внешнее имя ссылочного данного в контексте&gt;] = &lt;Ссылочное данное в контексте&gt;
local wo_creator -- Признак кем сформирована таблицы
local context_tbl = 'CONT' -- Имя, присвоенное контексту
 
------------------
-- Параметры
-- 1) 1-й параметр либо &lt;таблица контекста&gt;, либо пользовательская функция создания таблиц контекста (по образцу аналогично тому,
-- как это делается в creating_link_tables). В случае функции, при создании, изменении контекстом вместо creating_link_tables
-- запускается пользовательская функция.
-- 2) необязательный, если он не эквивалентен false, то обязательное обновление таблиц, сформированных в функции ранее.
-- Если нет обязательного обновления и если tbl_cont_result == &lt;таблица контекста&gt;, то вызов функции creating_link_tables,
-- таблицы aliases_cont, aliases_v_cont не изменяет.
-- Результаты : две таблицы формируемые в ней (aliases_cont, aliases_v_cont).
---
local function creating_link_tables(context, pr)
 if type(context) == 'function' then
 wo_creator = 'no creating_link_tables'
 local cont, v_cont = context( pr) --- context должен выдавать два результата ---
 if type(cont) == 'table' and type(v_cont) == 'table' then
 aliases_cont, aliases_v_cont = cont, v_cont
 else
 return nil, '!!! Ошибка. Оба результата функции context должны быть таблицами'
 end
 return aliases_cont, aliases_v_cont
 end
 ---------
 if pr then tbl_cont_result = nil end
 context = context or tbl_cont_default
 if type(context) ~= 'table' then return nil, '!!! Ошибка. type(context) ~= table ' end
 if context == tbl_cont_result then return aliases_cont, aliases_v_cont end ---- ! не надо обновлять aliases_cont, aliases_v_cont
 ---------
 aliases_cont, aliases_v_cont = {}, {} -- Будет обновление таблиц ---
 ----
 wo_creator = 'creating_link_tables'
 local path = '###: ' .. context_tbl
 ----------------------------
 local function cr_link_tables(item, path, seen) -- Рекурсивная функция ---
 seen = seen or { }
 path = path or context_tbl
 local mt
 if item == nil or seen[item] ~= nil then
 return
 elseif type(item) == 'table' then
 seen [item] = true
 -- Обработка метатаблицы (если есть в item)---
 mt = debug.getmetatable(item)
 if type(mt) == 'table' then cr_link_tables(mt, path .. '.' .. '.metatable###', seen) end
 ---
 local path_tm, kl_tm, k_tm
 for k, v in pairs(item) do
 if type(v) == 'table' then ---- таблица-значение --
 cr_link_tables (v, path .. '.' .. tostring(k), seen)
 else
 if not (type(v) == 'number' or type(v) == 'boolean' or type(v) == 'string') then
 if type(k) == 'string' then kl_tm = '.' .. tostring(k) else kl_tm = '[' .. tostring(k) .. '] ' end
 path_tm = path .. kl_tm -- составное внешнее имя строки таблицы (имя элемента)
 k_tm = tostring(v)
 if not aliases_cont[k_tm] then aliases_cont[k_tm] = path_tm end --- ### ?? возможна перезапись ---
 aliases_v_cont[path_tm] = v
 end
 end
 ----
 if type(k) == 'table' then ---- таблица-ключ --
 cr_link_tables (k, path ..'.' .. tostring(k), seen)
 else
 if not (type(k) == 'number' or type(k) == 'boolean' or type(k) == 'string') then
 if type(k) == 'string' then kl_tm = '.' .. tostring(k) else kl_tm = '[' .. tostring(k) .. '] ' end
 path_tm = '### ключ: ' .. path .. kl_tm
 k_tm = tostring(k)
 if not aliases_cont[k_tm] then aliases_cont[k_tm] = path_tm end --- ### ?? возможна перезапись ---
 aliases_v_cont[path_tm] = k
 end
 end
 end
 end
 end
 ----
 if next(context) then --- таблица context не пустая ----
 cr_link_tables(context, path)
 end
 tbl_cont_result = context
 return aliases_cont, aliases_v_cont
end
 
-- creating_link_tables() --- !! Подготовка контекста по умолчанию заранее ----
 
-- Обработка внешних локальных ссылочных данных контекста сереализации ---
local function creating_link_local()
 local level = 3, ii, name, value
 local k_tm, path_tm
 while 1 do
 if debug.getinfo(level, 'n') then
 ii = 1
 while 1 do
 name, value = debug.getlocal(level, ii)
 if name then
 if not (type(value) == 'table' or type(value) == 'number' or type(value) == 'boolean' or type(value) == 'string') then
 k_tm = tostring(value)
 path_tm = '###: LOC.' .. tostring(level) .. '.' .. tostring(ii) .. '.' .. name
 if not aliases_cont[k_tm] then aliases_cont[k_tm] = path_tm end --- ### ?? возможна перезапись ---
 aliases_v_cont[path_tm] = value
 end
 else
 break
 end
 ii = ii + 1
 end
 else
 break
 end
 level = level + 1
 end
 ------
end
 
------------------------------------------------------------
-- Функция tbl_to_str создает строку-скрипт Lua либо байт-код, при запуске которого восстанавливается (если &lt;Количество неразрешенных ссылок&gt; = 0) таблица t.
-- В этот же байт-код либо строку-скрипт в конец добавляется две таблицы ссылочных данных
---- Параметры:
-- 1. t - сереализуемая таблица
-- 2. ph_f - (не обязательный) путь файл сброса строки-скрипта либо признак (0 (по умолчанию) | 1) выдачи образа в виде (строки - скрипта | байт-кода)
-- 3. context - (не обязательный) контекст
-- 4. exclude - (не обязательный) таблица исключений вида: { [&lt;элемент-исключение&gt;] = '&lt;Описание&gt;' ........}
-- ! &lt;элемент-исключение&gt; при сереализации заменяется строкой:
-- '### Элемент-исключение: ' .. type (&lt;элемент-исключение&gt;) .. ' - ' .. &lt;Описание&gt;
-- Результат в зависимости от входных параметров: 1) байт-код скрипта или nil (если ошибка компиляции скрипта), &lt;Таблица неразрешенных ссылок&gt;
-- nil или &lt;Таблица неразрешенных ссылок&gt;, nil или текст ошибки компиляции скрипта
-- | 2) &lt;Строка-скрипт&gt;, nil или &lt;Таблица неразрешенных ссылок&gt;
-- | 3) Возвращается nil или &lt;Таблица неразрешенных ссылок&gt; и выполняется запись строки-скрипта в файл
local function tbl_to_str(t, ph_f, context, exclude)
 ----Контроль параметров ---
 if type(t) ~= 'table' then
 return nil, '!! Ошибка. Параметр t не таблица.'
 end
 ph_f = ph_f or 0
 local f_t
 if type(ph_f) == 'string' then
 f_t = io.open(ph_f, 'w')
 if type(f_t) ~= 'userdata' then return nil, '!! Ошибка при открытии файла' end
 end
 
 local context_yes, context_local_yes
 ------
 local name_alias = 'alias' --- для формирования команд с учетом alias ----
 local env_t = context_tbl
 local env = env_t .. '.t' --- #####
 local path = '###: TBL'
 local t_str = {} --- для сбора строк
 local level_t = 0 --- используется для формирования имен таблиц --
 --
 local context_err = {} --- таблица неразрешимых ссылок в context ---
 ---
 local function f_context_err(message, v) -- обработка ошибок ----
 context_err[v] = message
 return message .. v
 end
 ---
 exclude = exclude or {}
 local name_t, context_t = {}, {}
 -----------------------------------------
 local function tbl_str( t, path, seen )
 seen = seen or { }
 if seen[ t ] then
 return false, seen[ t ]
 end
 -------
 level_t = level_t + 1 --- для формирования имени таблицы --
 local n_t, mt = env .. tostring (level_t ), debug.getmetatable(t)
 seen [t] = n_t
 t_str [#t_str + 1] = n_t .. ' = {} --- создание таблицы: ' .. tostring(t) .. ' -- \n'
 local n_kt, n_vt , st, nm_t, path_t, aliases_cont_nm_t
 
 for k, v in pairs(t) do
 ---- Обработка поля -----
 if exclude[v] then v = '### Элемент-исключение: ' .. type(v) .. ' - ' .. tostring(exclude [v]) end --- обработка исключенных элементов ---
 if type(v) == 'string' then
 if v:find(']') then --- ! есть варианты строк, котрые не компилируются, например, строка [[ [[]] ]] ----
 n_vt = 'string.gsub([[' .. v:gsub(']', '@$#') .. ']], "@$#", "]")'
 else
 n_vt = '[[' .. v .. ']]'
 end
 elseif (type(v) == 'number' or type(v) == 'boolean') then
 n_vt = tostring (v)
 if n_vt == '1.#INF' or n_vt == 'inf' then n_vt = [[type (math) == 'table' and math.huge or '*** не вычисленное huge в поле таблицы']] end
 elseif type(v) == 'table' then --- Таблица-значение --
 n_vt = tostring(k)
 t_str[#t_str + 1] = ' --- ' .. n_vt .. ' - значение-таблица (начало) @ \n'
 st, n_vt = tbl_str(v, path .. '.' .. n_vt, seen)
 if not st then t_str[#t_str + 1] = ' -- Таблица ' .. n_vt .. ' была создана ранее ----\n ' end
 t_str[#t_str + 1] = ' --- ' .. n_vt .. ' - [' .. tostring(v) .. '] значение-таблица (конец) @ \n'
 else --- Ссылочное данное ---
 if not context_yes then --- создание контекста ---
 context_yes = true
 creating_link_tables(context)
 end
 nm_t = tostring(v)
 path_t = path .. '.' .. tostring(k)
 aliases_cont_nm_t = aliases_cont[nm_t]
 if not aliases_cont_nm_t and not context_local_yes then
 --- Добавление локального контекста --
 context_local_yes = true
 creating_link_local()
 -----------------
 aliases_cont_nm_t = aliases_cont[nm_t] --- повторное вычисление после добавления локального контекста --
 end
 
 context_t[nm_t] = aliases_cont_nm_t or f_context_err('*** в контексте сереализации нет ссылочного данного ', nm_t )
 if name_t[nm_t] then
 name_t[nm_t] = name_t [nm_t] .. ' | ' .. path_t
 else name_t[nm_t] = path_t
 end
 n_vt = name_alias .. '[ [[' .. nm_t .. ']] ]' or '### err'
 end
 
 --- Обработка ключа ----
 if exclude[k] then k = '### Элемент-исключение: ' .. type(k) .. ' - ' .. tostring(exclude[k]) end --- обработка исключенных элементов ---
 if type(k) == 'string' then
 if k:find(']') then --- ! есть варианты строк, котрые не компилируются, например, строка [[ [[]] ]] ----
 n_kt = 'string.gsub([[' .. k:gsub(']', '@$#') .. ']], "@$#", "]")'
 else
 n_kt = '[[' .. k .. ']]'
 end
 elseif (type(k) == 'number' or type(k) == 'boolean') then
 n_kt = tostring (k)
 if n_kt == '1.#INF' or n_kt == 'inf' then n_kt = [[type (math) == 'table' and math.huge or '*** не вычисленное huge в ключе таблицы']] end
 elseif type(k) == 'table' then --- Таблица-ключ ---
 n_kt = tostring(k)
 t_str[#t_str + 1] = ' --- ' .. n_kt .. ' - ключ-таблица (начало) @ \n'
 st, n_kt = tbl_str(k, path .. '.' .. n_kt, seen) --- Создание таблицы ключа и ее 'скобок' ----
 if not st then t_str[#t_str + 1] = ' -- Таблица ' .. tostring(k) .. ' была создана ранее ----\n ' end
 t_str[#t_str + 1] = ' --- ' .. n_kt .. ' - [' .. tostring(k) .. '] ключ таблица (конец) @ \n' ---
 else --- Ссылочное данное ключа ---
 if not context_yes then --- создание контекста ---
 context_yes = true
 creating_link_tables(context)
 end
 nm_t = tostring(k)
 path_t = path .. '.' .. nm_t .. '.ключ###' --- #### ---
 aliases_cont_nm_t = aliases_cont[nm_t]
 if not aliases_cont_nm_t and not context_local_yes then
 --- Добавление локального контекста --
 context_local_yes = true
 creating_link_local()
 ---
 aliases_cont_nm_t = aliases_cont[nm_t] --- повторное вычисление после добавления локального контекста --
 end
 
 context_t[nm_t] = aliases_cont_nm_t or f_context_err('*** в контексте сереализации нет ссылочного ключа ', nm_t )
-- name_t[nm_t] = path .. '.' .. nm_t .. '.ключ###' --- #### ---
 if name_t[nm_t] then
 name_t[nm_t] = name_t[nm_t] .. ' | ' .. path_t
 else name_t[nm_t] = path_t
 end
 n_kt = name_alias .. '[ [[' .. nm_t .. ']] ]' or '### err'
 end
 
 t_str[#t_str + 1] = n_t .. ' [ ' .. n_kt .. ' ] = ' .. n_vt .. ' \n'
 end
 
 --- Обработка метатаблицы ----
 if mt then -- создание и подключение метатаблицы в конце прохода по таблице с тем, чтобы она не мешала заполнять таблицу. ---
 t_str[#t_str + 1] = ' --- Создание метатаблицы --- \n'
 st, mt = tbl_str(mt, path .. '.' .. tostring(mt), seen)
 if not st then t_str[#t_str + 1] = '-- Метатаблица ' .. mt .. ' была создана ранее ----\n ' end
 t_str[#t_str + 1] = 'debug.setmetatable(' .. n_t .. ', ' .. mt .. ') --- подключение метатаблицы ' .. mt .. ' --- \n'
 end
 return true, n_t --- 1 - й результат - признак создания таблицы
 end
 ---------------------
 tbl_str(t, path)
 if not next(context_err) then context_err = nil end
 --- Формирование фрагментов скрипта -----
 local scr1 = 'local '.. name_alias .. ' = {...}; ' .. name_alias .. ' = ' .. name_alias .. ' [1] ; local ' .. env_t .. ' = {} \n'
 .. '\n if type(' .. name_alias .. ') == "table" then \n'
 local scr2 = '\n return ' .. context_tbl .. '.t1 \n else \n--- Две таблицы внутренних имен ссылочных данных : \n '
 .. ' -- 1) name_cont [&lt;Внутреннее имя ссылочного данного&gt;] = ###: &lt;Составное имя значения в контексте сереализации таблицы&gt; \n'
 .. ' -- 2) name_t [&lt;Внутреннее имя ссылочного данного&gt;] = ###: &lt;Список составных имен таблицы, ссылающиеся на значение &gt; \n'
 .. '--- ! Составные имена таблицы (если их неколько) разделены символом | . \n'
 
 local scr3 = '\n local name_cont = { '
 local scr4= '\n local name_t= { '
 local scr5 = '\n} '
 local scr6 = '\n return name_cont, name_t end \n '
 ----------------------------
 if type(f_t) == 'userdata' then --- Запись строки-скрипта в файл ----
 f_t: write(scr1)
 for i = 1, #t_str do f_t:write(t_str[i]) end
 f_t: write(scr2)
 f_t:write(scr3)
 for k, v in pairs(context_t) do f_t:write('\n [ [[' .. k .. ']] ] = [[' .. v ..']],') end
 f_t:write(scr5)
 f_t:write(scr4)
 for k, v in pairs(name_t) do f_t:write('\n [ [[' .. k .. ']] ] = [[' .. v ..']],') end
 f_t:write(scr5)
 f_t:write(scr6)
 f_t:close()
 return context_err --- таблица неразрешенных ссылок ---
 else ----------------------
 local s_a = {} --- для сбора строк ----
 ----
 local s = scr1 .. table.concat(t_str)
 s_a[#s_a + 1] = scr2
 s_a[#s_a + 1] = scr3
 for k, v in pairs(context_t) do s_a[ #s_a + 1 ] = '\n [ [[' .. k .. ']] ] = [[' .. v ..']],' end
 s_a[#s_a + 1] = scr5
 s_a[#s_a + 1] = scr4
 for k, v in pairs(name_t) do s_a[ #s_a + 1 ] = '\n [ [[' .. k .. ']] ] = [[' .. v ..']],' end
 s_a[#s_a + 1] = scr5
 s_a[#s_a + 1] = scr6
 s_a = table.concat(s_a) -- массив строк -&gt; строка
 -----
 s = s .. s_a
 if ph_f == 0 then
 return s, context_err --- строка-скрипт и таблица неразрешенных ссылок ----
 else
 local f, er = load_Lua(s)
 return f, context_err, er
 end
 end
 ------
end
----------------------------------------------------------------------
--- str_to_tbl (&lt;Байт-код скрипта для восстановления &lt;T&gt;, либо строка-скрипт)&gt;
-- [, &lt;Контекст (таблица или функция создания контекста восстановления)&gt;] )
--- Результаты. Их может быть один или три (если есть висячие ссылочные данные):
-- 1-й - восстановленная таблица с пометкой висячих ссылок, если такие существуют в виде составных имен в контексте сереализации.
-- Второй и третий – nil, если висячих ссылок нет или две таблицы:
-- - таблица висячих ссылок с указанием составных имен-адресов в кон-тексте сереализации;
-- - таблица висячих ссылок с указанием составных имен –адресов в &lt;T&gt;.
-- В таблицах висячих ссылок есть данные, облегчающие восстановление этих ссылок.-
------
local function str_to_tbl(str_fun, context)
-- MessageDb (2, 0, 'Скрипт', ' str_fun str_fun: \n' .. dump_str ( str_fun , ' ', 0))
 if type(str_fun) ~= 'string' and type(str_fun) ~= 'function' then
 return nil, '! Ошибка в первом параметре ф-ции str_to_tbl (он должен быть типа string или function )'
 end
 
 local err
 if type(str_fun) == 'string' then
 if str_fun == '' then return nil, '! Ошибка в первом параметре ф-ции str_to_tbl (он не должен пустой строкой)' end
 str_fun , err = load_Lua(str_fun); if err ~= nil then return nil, err end
 end
 ---------
 local cont_t, tbl_t = str_fun()
 if type(cont_t) ~= 'table' or type(tbl_t) ~= 'table' then return nil, '! Ошибка в ф-ции str_to_tbl (cont_t или tbl_t не таблица)' end
 if next(cont_t) then --- cont_t не пустая таблица: создание контекста ---
 creating_link_tables(context)
 --- Добавление локального контекста --
 creating_link_local()
 end
 
 --- Проверка существования ссылочных данных таблицы -----
 local cont_err, t_err = {}, {}
 local N_err = 0
 local v_tm
 --- Первый этап разрешения ссылок ---
 for k, v in pairs(cont_t) do ---- k - внутреннее имя, v - внешнее имя
 v_tm = aliases_v_cont[v]
 if v_tm then --- есть ссылочное данное ---
 cont_t[k] = v_tm
 else --- сбор неразрешенных ссылок ---
 N_err = N_err + 1
 cont_err[k] = v --- v - внешнее имя в контексте --
 t_err [k] = tbl_t[k] ---- tbl_t[k] - список внешних имен в таблице ---
 end
 end
 --- Второй этап разрешения ссылок (имеет смысл для быстрого поиска использовать таблицу,
 -- созданную по данным aliases_v_cont: {[&lt;Последняя составляющая внешнего имени контекста&gt;] = &lt;Ссылочное данное&gt;} ---
-- MessageDlg(1, 1, 'Скрипт str_to_tbl -----------------------', 'N_err = ' .. dump_tbl(N_err, ' ', 0, 1))
 if N_err &gt; 0 then
 local i_mt, l_v, nm_v
 local aliases_v_cont_t = {} -- вспомогательная таблица для быстрого поиска последней составляющей внешнего имени ---
-- if N_err &gt; 10 then
 for k_k, v_v in pairs(aliases_v_cont) do ---
 l_v = # k_k
 i_mt = 0
 for i = l_v , 1, -1 do if k_k:sub(i, i) == '.' then i_mt = i; break end end --- #### Для выделения последней составляющей внешнего имени ---
 l_v = -(l_v - i_mt)
 aliases_v_cont_t[k_k:sub(l_v)] = v_v
 end
-- end
-- MessageDlg(1, 1, 'Скрипт str_to_tbl -----------------------', 'N_err = ' .. dump_tbl(N_err, ' ', 0, 1))
 for k, v in pairs(cont_err) do
 if not (v:find( '*** в контексте сереализации нет')) then
 l_v = # v
 i_mt = 0
 for i = l_v , 1, -1 do if v:sub(i, i) == '.' then i_mt = i; break end end --- #### Для выделения последней составляющей внешнего имени (.&lt;Имя&gt;)---
 l_v = -(l_v - i_mt) --- для выделение последней составляющей внешнего имени (отрицательное число) ---
 nm_v = aliases_v_cont_t[v:sub(l_v)]
 if nm_v then
 cont_t[k] = m_v
 N_err = N_err -1
 cont_err[k] = nil
 t_err[k] = nil
 end
 end
 end
 end
 -----
 if N_err &gt; 0 then
 return str_fun(cont_t), cont_err, t_err
 else
 return str_fun(cont_t)
 end
end
 
----- Вывод таблицы в строку ------
-- Преобразование таблицы без ее метатаблицы (ключи и значения : table, boolean, number, string) в текстовое представление
-- в соответствии с синтаксисом языка lua ---
---- Можно использовать для сохранения таблиц в текстовом виде, с возможностью последующего восстановления
-- со следующими ! ограничениями:
-- 1) ключи и поля типа: table, boolean, number, string;
-- 2) все элементы таблицы (ключи и поля) типа table должны быть уникальными (в пределах таблицы с учетом всех ее вложенностей).
------ Параметры: 1) t - таблица (выводятся все вложения );
-- 2) не обязательный i - начальная строка формирования отступа при выводе вложений (например, " "); если i = '',
-- то строки таблицы выводятся без отступов
-- Результат (два): 1) строка (тремя звездочками помечены проблемные места);
-- 2) количество записей, которые нельзя представить в текстовом виде для последующего восстановления таблицы ----
local key_tbl_stateOS= "--таблица: "
-----
local function tbl_to_string(t, i)
 if type(t) ~= "table" then
 return nil
 end
 i = i or ''
 local tab = "\t"
 if i == '' then tab ='' end
 
 local ltime_str
 if GetLocalTimeMls then
 ltime_str= GetLocalTimeMls()
 else
 ltime_str= os.time() --- #### для пакета в котором недоступен GetLocalTimeMls
 end
 
 local tbl = {} --- для результата ----
 local no_unpack =0
 -----------
 local function dump(t, i, seen) ---------
 if seen then
 if seen[t] then
 return seen[t]
 end
 tbl[#tbl + 1] = " { -- " .. tostring(t) .. "\n"
 else
 seen={} -- просмотренные --
 tbl[#tbl + 1] = "{" .. key_tbl_stateOS .. string.format("%.0f", ltime_str) .. " -- время создания os.time() \n"
 end
 seen[t] = tostring(t)
 if debug.getmetatable(t) then
 no_unpack = no_unpack + 1;
 tbl [#tbl + 1] = i .. ' --- *** У таблицы ' .. tostring(t) .. ' есть метатаблица, которая в функции tbl_to_string не обрабатывается \n'
 end
 local bracket = true -- скобка (начало) ---
 --
 for k,v in next, t do
 if type(k) == "table" then
 if bracket then tbl [#tbl + 1] = i .. " [\n"; bracket = false else tbl [#tbl +1] = i .. ", [\n" end
 if dump(k, i .. tab, seen) then
 tbl [#tbl + 1] = "*** -&gt; " .. tostring(k) .. '\n'
 no_unpack = no_unpack + 1
 end
 tbl [#tbl + 1] = i .. " ] = "
 else
 if bracket then tbl [#tbl + 1] = i .. " [ "; bracket = false else tbl [#tbl +1] = i .. ", [ " end
 if type(k) == "function" or type(k) == "userdata" or type(k) == "thread" then
 tbl [#tbl +1] = "*** " .. type(k)
 no_unpack = no_unpack + 1
 end
 if type(k) == "string" then
 tbl [#tbl + 1] = "'".. tostring(k) .. "'"
 else
 tbl [#tbl + 1] = tostring(k)
 end
 tbl [#tbl + 1] = " ] = "
 end
 
 if type(v) == "table" then
 if seen[v] then
 tbl [#tbl + 1] = "*** -&gt; " .. tostring(v) .. '\n'
 no_unpack = no_unpack + 1
 else
 dump(v, i .. tab, seen) ---
 end
 else
 if type(v) == "function" or type(v) == "userdata" or type(v) == "thread" then
 no_unpack = no_unpack +1
 tbl [#tbl + 1] = "*** " .. tostring(v) .. '\n'
 else
 if type(v) == "string" then
 tbl [#tbl + 1]= '"' .. v .. '" \n'
 else
 tbl [#tbl + 1] = tostring(v) .. "\n"
 end
 end
 end
 end
 --
 tbl[#tbl + 1] = i .. " } \n"
 end
 ---------------------
 dump(t,i)
 tbl[#tbl] = i .. "}".. key_tbl_stateOS .. string.format("%.0f", ltime_str) .. "\n" --- !!! заменяется последняя фугурная скобка ---
 return table.concat(tbl), no_unpack ----- Результат: 1) строка ; 2) количество значений, не представимых в виде строки ----
end
-----
---- Преобразование строки - таблицы в таблицу --------------------
--- Результат: таблица ------
local function string_to_tbl(str_tbl)
-- Msg_Message (" string_to_tbl ", "return " .. str_tbl)
 if str_tbl:find("{") == nil then return nil end --- если в строке str_tbl нет {
 local tbl , err_tbl = load_Lua ("return " .. str_tbl) ---- assert (load_OS ( "retur " .. 4)) -- $$$$
 if err_tbl ~= nil then
 if Msg_Message and MessageDlg then
 Msg_Message(" string_to_tbl ", "!!! Ошибка в синтаксисе таблицы: " .. err_tbl .. '\n' .. str_tbl) --- err_tbl)
 MessageDlg(1, 1, 'string_to_tbl', "!!! Ошибка в синтаксисе таблицы: " .. err_tbl .. '\n' .. str_tbl)
 end
 return nil
 end
 return tbl()
end
------
-----------------------------------------------
---- ! Оформление в виде модуля------
 return {tbl_to_str = tbl_to_str, str_to_tbl = str_to_tbl, creating_link_tables = creating_link_tables
 , dump_tbl = dump_tbl, tbl_to_string = tbl_to_string, string_to_tbl = string_to_tbl} ---
--------------------------------------
Скрытый текст
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
 --- Проверка модуля ---
 -- !! Вывод результатов тестирования модуля длинный. Поэтому выполняется в текстовый файл ---
IsRun = true
 
function main()
 ---- Подключение модуля сереализации/десереализации ----
 local table_serialization = require('table_serialization_all') --- Подключение модуля ---
 ---
 local tbl_to_str = table_serialization.tbl_to_str
 local str_to_tbl = table_serialization.str_to_tbl
 local creating_link_tables = table_serialization.creating_link_tables
 local dump_tbl = table_serialization.dump_tbl
 local tbl_to_string = table_serialization.tbl_to_string
 local string_to_tbl = table_serialization.string_to_tbl
 
 -----==============================================================--------------------------------------------------------
 message("Начало теста ----")
 
 local sss, sss_t , tbl_str, err_tbl_str
 local file_rez, f_str, file_ser
 
 ---- Файл сохранения лога (обнуляется при запуске текста) ----
 file_rez = io.open('D:\\log_ser.txt', 'w'); file_rez:close() --- Очистка file_rez ---
 ------
 file_rez = io.open('D:\\log_ser.txt', 'a+') --- 'rb' | 'a+' | 'wb'
 
 --------------------------------
 -- Пример функции, используемой в таблице test_tbl в качестве ее элемента ---
 local function f_test()
 return ' !!! Вызов функции из сереализированной таблицы \n'
 end
 ---
 
 ---- Файл хранения сереализации (если он пустой, то в нем сохраняется строка сереализации глобальной таблицы Lua _G)----
 ---- !! Для повтора записи в этот файл его надо очистить ---
 file_ser = io.open('D:\\Ser_f.txt', 'r+');
 
 ------ Добавление записей в таблицу _G (потом можно проверить, что эти переменные участвуют в сереализхации/десереализации _G) ---
 aaaa1 = 5 -- Добавление записи в таблицу _G ---
 aaaa2 = 'Добавление записи в таблицу _G' -- Добавление записи в таблицу _G ---
 
 ----------------------------------------------------------------------------
 file_rez:write('--------- Печать таблицы _G: \n' .. dump_tbl(_G, ' ', 0))
 ---
 f_str = file_ser:read ('*a') -- Чтение файла хранения сереализации --
 file_rez:write('\n --- Содержимое file_ser:read: \n' .. dump_tbl(f_str, ' ', 0))
 ------
 if #f_str &gt; 0 then -- Есть не пустая строка в файле хранения сереализованной таблицы _G, то десереализация ---
 tbl_str = str_to_tbl(f_str)
 file_rez:write('\n --- Результат десереализации таблицы из строки файла file_ser: \n' .. dump_tbl(tbl_str, ' ', 0))
 else -- Сереализация G и запись полученной строки в файл ---
 --- Выполнение сереализации (два результата: строка и если есть ошибки сереализации, то таблица элементов типа function, thread, userdata) ---
 tbl_str, err_tbl_str = tbl_to_str(_G)
 ---
 file_ser:write(tbl_str) --- Запись сереализованной таблицы _G в файл ---
 file_rez:write('\n --- Запись tbl_to_str(_G) в file_ser \n')
 if err_tbl_str then -- Ошибки сереализации: если они есть --
 file_rez:write('\n --- Ошибки при сереализации _G (&lt;Таблица неразрешенных ссылок&gt;) \n')
 file_rez:write(dump_tbl(err_tbl_str, ' ', 0))
 end
 end
 
 ----- Таблица test_tbl будет нормально обработана tbl_to_str, но tbl_to_string ее обработать не может
 -- и это правильно (не выполняются ограничения для использования tbl_to_string)
 local t1 = {5,'t1'}
 local test_tbl = {1, 2 -- "Простой пример" таблицы для выполнения сереализации ---
 , {3, 4, ['Таблица'] ={5}, [t1] = '[t1]'}
 , [t1] = 7
 , ['Тестирование вызова'] = f_test ---- f_test - функция ---
 }
 setmetatable(test_tbl, t1) -- подключение t1 к test_tbl в качастве метатаблицы --
 ------------------------
 sss, sss_t = tbl_to_str(test_tbl)
 file_rez:write('\n\n--- Результат сереализации таблицы "Простой пример" с помощью tbl_to_str: \n'.. sss)
 sss = str_to_tbl(sss)
 
 file_rez:write('\n\n--- Печать восстановленной таблицы (функцией str_to_tbl) "Простой пример": \n' .. dump_tbl(sss, ' ', 0))
 ---- Вызов функции из сереализированной таблицы ---
 file_rez:write('\n\n--- Печать результата вызова функции таблицы "Простой пример": \n' .. sss['Тестирование вызова']())
 -----------------
 
 sss, sss_t = tbl_to_string(test_tbl)
 file_rez:write('\n\n--- Результат сереализации таблицы "Простой пример" с помощью tbl_to_string'
 .. '\n ( ! будут ошибки, помеченные ***, т.к. не выполняются ограничения для использования tbl_to_string): \n'.. sss)
 sss = string_to_tbl(sss)
 file_rez:write('\n\n--- Печать результата функции string_to_tbl(&lt;Строка с ошибками сереализации&gt;) (! ожидаемый результат nil): \n' .. dump_tbl(sss, ' ', 0))
 -----------------
 
 tbl_str = {1, 2 -- "Совсем простой пример" таблицы для выполнения сереализации ---
 , {3, 4, {5}, [t1] = '[t1]'}
 , [ { {}, '[8]' } ] = {'Совсем простой пример'}
 }
 sss, sss_t = tbl_to_string(tbl_str)
 file_rez:write('\n\n--- Результат сереализации таблицы "Совсем простой пример" с помощью tbl_to_string: \n'.. sss)
 sss = string_to_tbl(sss)
 file_rez:write('\n\n--- Печать восстановленной функцией string_to_tbl таблицы "Совсем простой пример": \n' .. dump_tbl(sss, ' ', 0))
 ------
 sss, sss_t = tbl_to_str(tbl_str)
 file_rez:write('\n\n--- Результат сереализации таблицы "Совсем простой пример" с помощью tbl_to_str =================: \n'.. sss)
 sss = str_to_tbl(sss)
 file_rez:write('\n\n--- Печать восстановленной таблицы (функцией str_to_tbl) "Совсем простой пример" =============: \n' .. dump_tbl(sss, ' ', 0))
----------------
----------------
 --- Определение процессорного времени выполнения сереализации/десереализации таблицы _G с помощью tbl_to_str/str_to_tbl---
 local T = os.clock() * 1000
 tbl_str, err_tbl_str = tbl_to_str(_G)
 T = tostring(os.clock() * 1000 - T)
 message('Длительность сереализации таблицы _G функцией tbl_to_str: ' .. T)
 file_rez:write('\n\n--- Длительность сереализации таблицы _G функцией tbl_to_str:' .. T)
 ---
 T = os.clock() * 1000
 tbl_str, err_tbl_str = str_to_tbl (tbl_str)
 T = tostring(os.clock() * 1000 - T)
 message('Длительность десереализации таблицы _G функцией str_to_tbl: ' .. T)
 file_rez:write('\n\n--- Длительность десереализации таблицы _G функцией str_to_tbl: ' .. T)
 -- file_rez:write('Печать десереализованной таблицы G: \n' .. dump_tbl(tbl_str, ' ', 0))
 --------------------------------------------------------------------------------------------
 file_rez:close()
 file_ser:close()
 message("Конец теста ----")
 -------------------------------------------------------------------------------------------------------------
-- while IsRun do
-- sleep(100)
-- end
 ------------------
end
 
function OnStop()
 IsRun = false
 return 10000
end