Разделы

• 1. Введение
• 2. Описание языка
  • 2.1. Лексические соглашения
  • 2.2. Значения и типы
  • 2.3. Переменные
  • 2.4. Выражения
    • 2.4.1. Оператор присваивания
    • 2.4.2. Арифметические операции
    • 2.4.3. Операции сравнения
    • 2.4.4. Логические операции
    • 2.4.5. Побитовые операторы
    • 2.4.6. Конкатенация
    • 2.4.7. Приоритеты операций
    • 2.4.8. Операторы перехода
  • 2.5. Таблицы
    • 2.5.1. Создание таблиц, виды таблиц
    • 2.5.2. Доступ к элементам таблицы
  • 2.6. Управляющие конструкции (if, for, while, do while)
  • 2.7. Функции
    • 2.7.1. Объявление функций
    • 2.7.2. Функции с переменным количеством аргументов (мультиаргументность)
    • 2.7.3. Замыкания
    • 2.7.4. Вызов функции
  • 2.8. Области видимости (контексты, пространства имен, блоки)
    • 2.8.1. Пространства имен
    • 2.8.2. Контексты
    • 2.8.3. Блоки
    • 2.8.4. Области видимости
  • 2.9. Обработка ошибок
  • 2.10. Сборщик мусора
  • 2.11. Препроцесс
• 3. Интерфейс программирования приложений (API)
  • 3.1. Стек
  • 3.2. Резервация памяти
  • 3.3. Сообщения
  • 3.4. Типы данных
  • 3.5. Функции
    • 3.5.1. Базовые функции скриптоввой системы
    • 3.5.2. Функции для вставки на вершину стека значения
    • 3.5.3. Перевод значений со стека в скриптовую ситему (экспорт (stack => script))
    • 3.5.4. Функции для получения со стека (stack => C(++))
    • 3.5.5. Функции для работы с аргументами в вызванной C(++) функции из скриптовой системы (script => C(++) function)
    • 3.5.6. Функции отладки (DEBUG)
    • 3.5.7. Функции для работы с препроцессом
• 4. Стандартная библиотека

3.5.1. Базовые функции скриптоввой системы

const char* s4g_get_str_type(s4g_type tt, char* str_type = 0);
// возвращает строковое представление типа tt в str_type

s4g_main* s4g_init(const char* name);
/* инициализация скриптовой системы, name – имя новой системы,
    в случае если используется несколько скриптовых систем то
    сообщения от них будут поступать в одну и ту же функцию вывода
    сообщений, и для идентификации сообщений будет использовано имя скриптововй системы */

void s4g_export_stdlib(s4g_main* s4gm);
// экспорт языковых функций и типов в языковое пространство имен скриптов

void s4g_kill(s4g_main* s4gm)
// завершение работы скриптовой системы и ее удаление

void s4g_clear(s4g_main* s4gm);
// очистка скриптововй системы (в основном используется дл перезагрузки, так как после очитски система будет пустая)

int s4g_load_file(s4g_main* s4gm, const char* file);
// загрузка кода скрипта из файла, возвращает состояние загрузки, 0 удачно, -1 ошибка

int s4g_load_str(s4g_main* s4gm, const char* str);
// загрузка кода скрипта из строки, возвращает состояние загрузки, 0 удачно, -1 ошибка

void s4g_set_rf(s4g_report_func rf);
// установка новой функций для выдачи сообщений

void s4g_gen_msg(s4g_main* s4gm, int level, const char* format, ...)
// генерация сообщения для скриптовой системы, level – уровень критичности (см. 3.3)

void s4g_call_gc(s4g_main* s4gm)
// вызов сборщика мусора

long s4g_gc_mem_busy(s4g_main* s4gm);
// количество занятой памяти в байтах

long s4g_gc_mem_allocated(s4g_main* s4gm);
// количество выделенной памяти в байтах

s4g_value* s4g_gcget_null(s4g_main* s4gm);
// возвращает константное значение null (во внутреннем представлении)

s4g_value* s4g_gcget_bool(s4g_main* s4gm,bool bf);
// возвращает константное значение bool, значение определяется на основании bf (во внутреннем представлении)

s4g_value* s4g_gcget_true(s4g_main* s4gm);
// возвращает константное значение bool (true)  (во внутреннем представлении)

s4g_value* s4g_gcget_false(s4g_main* s4gm);
// возвращает константное значение bool (false) (во внутреннем представлении)