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_BYTE`	1-байтовый, со знаком целое число
`'CDF_CHAR'`	1 байт, тип символьных данных со знаком, который сопоставляется с MATLAB^® `char` или `string` класс
`'CDF_INT1'`	1-байтовый, со знаком целое число
`'CDF_UCHAR'`	1 байт, беззнаковый тип символьных данных, который сопоставляется с MATLAB `uint8` класс
`'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

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

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

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

Ссылки

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

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

Информацию об авторских правах см. в cdfcopyright.txt файл.

См. также

cdflib.closeVar | cdflib.deleteVar

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