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 байт, символьный тип данных без знака, который сопоставляет с `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 файл.

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

cdflib.closeVar | cdflib.deleteVar

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