Смотрите также. 3.60. GetListOfInstances()

ISO 10303-22-10.10.4; ISO 10303-24-6.8.4

3.60. GetListOfInstances()

Как работать с функцией исследования образа создаваемого обменного файла.

Необходимое условие – включение

#include ‘adbe.h’

Функция GetListOfInstances (), физически расположенная в x_stkit.dll, возвращает значение типа CADB*.

Функцию имеет смысл вызывать только в начале режима «3. Запись данных в обменный файл», поскольку во все другие моменты времени возвращаемое функцией значение не будет иметь осмысленного содержания. После завершения работы с возвращенным значением с ним делать ничего не нужно. Попытки изменения содержащихся в возвращаемом значении данных могут привести к непредсказуемым результатам, поэтому эти данные – только для чтения.

Действия, которые можно выполнять над возвращаемым значением:

1. Получение идентификатора экземпляра по номеру в будущем обменном файле

SdaiInteger InstanceName = nnn.

CADB* ListOfInstances = GetListOfInstances();

CADB* Investigated = ListOfInstances-> GetByPosition(InstanceName - 1);

/* Здесь следует учесть, что в существующей версии генератора номера записей InstanceName присваиваются последовательно, начиная с 1, а позиции элементов в списке начинаются с 0*/

SdaiInstance InvestigateInstance = Investigated-> Content.II.KeyId;

/* Далее с помощью обычных функций SDAI можно исследовать тип и значение полученного экземпляра */

2. Получение номера в обменном файле по идентификатору экземпляра

SdaiInstance InvestigatedInstance = nnn

SdaiInteger InstanceName = ListOfInstances-> GetIByI(InvestigatedInstance);

3.61. GetListOfSchemaInstances()

SdaiNPL GetListOfSchemaInstances (

SdaiRep Repository

);

Функция GetListOfSchemaInstances() возвращает список, содержащий все экземпляры схемы, доступные в текущей сессии.

Экземпляры схемы представлены идентификаторы экземпляров сущности типа schema_instance. В существующей версии SDAI может быть указан только репозиторий “SDAI00.RP”, идентификатор которого может быть получен с помощью функции sdaiOpenRepositoryBN().

После использования возвращенный список должен быть уничтожен с помощью функции sdaiDeleteNPL().

3.62. GetListOfSDAIModels()

SdaiNPL GetListOfSDAIModels

(SdaiRep Repository);

Функция GetListOfSDAIModels() возвращает список, содержащий все экземпляры схемы, доступные в текущей сессии.

SDAI-модели представлены идентификаторы экземпляров сущности типа sdai_model. В существующей версии SDAI может быть указан только репозиторий “SDAI00.RP”, идентификатор которого может быть получен с помощью функции sdaiOpenRepositoryBN().

После использования возвращенный список должен быть уничтожен с помощью функции sdaiDeleteNPL().

3.63. sdaiGetLowerIndex()

SdaiInteger sdaiGetLowerIndex (

SdaiArray array

);

Функция sdaiGetLowerIndex() определяет низший (младший)индекс в массиве. EXPRESS позволяет массивам иметь определенные пользователем высшие и низшие предельные значения, а эта функция возвращает низшее предельное значение массива. В этой реализации массивы всегда начинаются с нуля, поэтому эта функция всегда возвращает 0.