Здесь описаны функции и структуры для использования языка программирования Gentee в проектах на Golang.

• ​type Custom​

• ​type EmbedItem​

• ​type Settings​

• ​Customize(custom *Custom) error​

• ​New() *Gentee​

• ​(g *Gentee) Compile(input, path string) (*Exec, int, error)​

• ​(g *Gentee) CompileAndRun(filename string) (interface{}, error)​

• ​(g *Gentee) CompileAndRun(filename string) (*Exec, int, error)​

• ​(exec *Exec) Run(settings Settings) (interface{}, error)​

• ​Version() string​

Типы

type Custom

Тип Custom служит для дополнительной настройки компилятора и виртуальной машины. Передается при вызове функции Customize.

• Embedded []EmbedItem - массив дополнительных функций для стандартной библиотеки.

type EmbedItem

Тип EmbedItem описывает функцию, подключаемую к стандартной библиотеки. Используется в типе Custom.

• Prototype string - описание функции на языке Gentee. Например, myfunc(str,int) int.

• Object interface{} - соответствующая golang функция.

type Settings

Тип Settings служит для указания дополнительных параметров при запуске байт-кода в методе Run.

• CmdLine []string - массив параметров командной строки.

• Stdin *os.File - свой собственный стандартный ввод.

• Stdout *os.File - свой собственный стандартный вывод.

• Input []byte - предопределенный стандартный ввод (stdin). Может использоваться, например, в функции ReadString.

• Cycle uint64 - максимальное количество итераций в цикле. По умолчанию, равно 16000000.

• Depth uint32 - максимальная вложенность исполняемых блоков. Ограничивает глубину рекурсии. По умолчанию, равно 1000.

• SysChan chan int - канал для отправки команд SysSuspend (1), SysResume (2), SysTerminate (3). Позволяет управлять выполнением скрипта извне.

  • SysSuspend - приостановить работу скрипта и всех потоков.

  • SysResume - возобновить работу скрипта и всех потоков.

  • SysTerminate - завершить работу скрипта и всех потоков.

    settings.SysChan = make(chan int)
    go func() {
        _, err = exec.Run(settings)
    }()
    settings.SysChan <- gentee.SysTerminate

Функции и методы

Customize(custom *Custom) error

Функция Customize служит для дополнительной настройки компилятора и виртуальной машины. Она должна вызываться раньше всех функций. Функция возвращает значение ошибки.

New() *Gentee

Функция New создает рабочее пространство для компиляции исходного кода.

(g *Gentee) Compile(input, path string) (*Exec, int, error)

Функция Compile компилирует скрипт переданный в input. В параметре path можно указать путь к скрипту. Функция возвращает структуру с байт-кодом, номер модуля и значение ошибки.

(g *Gentee) CompileAndRun(filename string) (interface{}, error)

Функция CompileAndRun компилирует скрипт из файле filename и выполняет его. Функция возвращает результат выполнения скрипта и значение ошибки.

(g *Gentee) CompileFile(filename string) (*Exec, int, error)

Функция CompileFile компилирует скрипт из файла filename. Функция возвращает структуру с байт-кодом, номер модуля и значение ошибки.

(exec *Exec) Run(settings Settings) (interface{}, error)

Функция Run выполняет байт-код из структуры exec. В параметре settings можно указать дополнительные настройки. Функция возвращает результат выполнения скрипта и значение ошибки.

Version() string

Функция Version возвращает номер текущей версии языка.