Exponenta Banner
exponenta event 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 байт, неподписанный символьный тип данных, который сопоставляется с 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

Ссылки

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

Для использования этой функции необходимо ознакомиться с интерфейсом CDF C. Прочитайте документацию CDF в CDF website.

Для получения информации об авторских правах см. cdfcopyright.txt файл.

См. также

|

Темы

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

Поддержка