Exponenta Banner

cdflib.createVar

Создайте новую переменную

Синтаксис

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance)

Описание

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance) создает новую переменную в файле Формата общих данных (CDF) с заданными характеристиками.

Входные параметры

cdfId

Идентификатор CDF-файла, возвращенного вызовом cdflib.create или cdflib.open.

varname

Вектор символов или строковый скаляр, который задает имя, которое вы хотите присвоить переменной.

datatype

Тип данных переменной в виде одного из следующих векторов символов или строковых скаляров, содержащих допустимый тип данных CDF или его числовой эквивалент.

Тип данных CDFОписание
'CDF_BYTE1 байт, целое число со знаком
'CDF_CHAR'

1 байт, подписанный символьный тип данных, который сопоставляет с MATLAB® char или string класс

'CDF_INT1'1 байт, целое число со знаком
'CDF_UCHAR'

1 байт, символьный тип данных без знака, который сопоставляет с uint8 MATLAB класс

'CDF_UINT1'1 байт, беззнаковое целое
'CDF_INT2'2 байта, целое число со знаком
'CDF_UINT2'2 байта, беззнаковое целое
'CDF_INT4'4 байта, целое число со знаком
'CDF_UINT4'4 байта, беззнаковое целое
'CDF_FLOAT'4 байта, плавающая точка
'CDF_REAL4'4 байта, плавающая точка
'CDF_REAL8'8 байтов, плавающая точка.
'CDF_DOUBLE'8 байтов, плавающая точка
'CDF_EPOCH'8 байтов, плавающая точка
'CDF_EPOCH16'два 8 байтов, плавающая точка

numElements

Число элементов на данную величину. Значение должно быть 1 для всех типов данных, за исключением 'CDF_CHAR' и 'CDF_UCHAR'.

dims

Вектор из степеней размерностей; пустой, при отсутствии степеней размерности.

recVariance

Задает отклонение записи: true или false.

dimVariance

Вектор из logicals; пустой, при отсутствии размерностей.

Выходные аргументы

varNum

Числовой идентификатор для переменной. Переменные числа основаны на нуле.

Примеры

Создайте CDF-файл и затем создайте переменную под названием 'Time' в CDF. Переменная не имеет никаких размерностей и варьируется через записи. Чтобы запустить этот пример, вы должны быть в папке с возможностью записи.

cdfid = cdflib.create('your_file.cdf');

% Initially the file contains no variables.
info = cdflib.inquire(cdfid)

info = 

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 0
    numvAttrs: 0
    numgAttrs: 0

% Create a variable in the file.
varNum = cdflib.createVar(cdfid,'Time','cdf_int1',1,[],true,[]);

% Retrieve info about the file again to verify variable was created. 
% Note value of numVars field is now 1.
info = cdflib.inquire(cdfid)

info = 

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 1
    numvAttrs: 0
    numgAttrs: 0

% Clean up
cdflib.delete(cdfid);

clear cdfid

Ссылки

Эта функция соответствует стандартной программе API библиотеки CDF C CDFcreatezVar.

Чтобы использовать эту функцию, необходимо быть знакомы с интерфейсом C CDF. Ознакомьтесь с документацией CDF на веб-сайте CDF.

Дополнительные сведения см. в cdfcopyright.txt файл.

Смотрите также

|

Темы

Документация MATLAB

Поддержка