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 байт, подписанный символьный тип данных, который сопоставляет с классом `string` или MATLAB^® `char`
`'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.

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

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

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

cdflib.closeVar | cdflib.deleteVar

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