FirebirdSQL logo
 Написание плагиновЗаключение 

IFirebirdConf

Интерфейс IFirebirdConf — доступ к основной конфигурации Firebird.Используется как для конфигурации по умолчанию, заданной конфигурациейfirebird.conf, так и для каждой базы данных, скорректированной спомощью database.conf. Чтобы ускорить доступ к значениям конфигурации,вызовы, обращающиеся к фактическим значениям, используют целочисленныйключ вместо символьного имени параметра. Ключ стабилен во время работысервера (т. е. плагин может получить его один раз и использовать дляполучения значения параметров конфигурации для разных баз данных).

  1. getKey

    unsigned getKey(const char* name)

    Возвращает ключ для заданного имени параметра. ~0 (все биты равны 1)возвращается в случае, когда такого параметра нет.

  2. asInteger

    ISC_INT64 asInteger(unsigned key)

    Возвращает значение целочисленного параметра.

  3. asString

    const char* asString(unsigned key)

    Возвращает значение строкового параметра

  4. asBoolean

    FB_BOOLEAN asBoolean(unsigned key)

    Возвращает значение логического параметра. Стандартные аббревиатуры(1/true/t/yes/y) рассматриваются как true, все остальные — как false.

  5. getVersion

    unsigned getVersion(StatusType* status)

    Возвращает версию диспетчера конфигурации, связанную с этим интерфейсом.Различные версии диспетчера конфигурации могут сосуществовать на одном сервере, например, когдастарый движок БД используется на современном сервере. Обратите внимание — ключи (см. getKey())разных версий не совпадают и при неправильном использовании всегда будут возвращать 0/nullptr/false.

IInt128

Интерфейс IInt128 помогает работать со 128-битными целыми числами, которые используется в качестве базового типадля числовых и десятичных чисел с точностью более 18.

  1. toString

    void toString(StatusType* status, const FB_I128* from, int scale, unsigned bufferLength, char* buffer)

    Преобразует 128-битное целое значение в строку с учетом масштаба.

  2. fromString

    void fromString(StatusType* status, int scale, const char* from, FB_I128* to)

    Собирает 128-битное целое значение из строки с учетом масштаба.