Main Content

cdflib.setVarPadValue

Specify pad value used with variable

Syntax

cdflib.setVarPadValue(cdfId,varNum,padvalue)

Description

cdflib.setVarPadValue(cdfId,varNum,padvalue) specifies the pad value used with a variable in a Common Data Format (CDF) file.

Input Arguments

cdfId

Identifier of a CDF file, returned by a call to cdflib.create or cdflib.open.

varNum

Numeric value identifying a variable in the file. Variable numbers are zero-based.

padValue

Value to use a pad value for the variable. The data type of the pad value must match the data type of the variable.

Examples

Create a CDF, create a variable in the CDF, and then set the pad value used with the variable. To run this example, you must be in a writable folder.

cdfId = cdflib.create("your_file.cdf");

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

% Get the current pad value used with the variable 
padval = cdflib.getVarPadValue(cdfId,varNum)
padval =

  int8

   -127
% Change the pad value for the variable
cdflib.setVarPadValue(cdfId,varNum,int8(1));

% Check the new pad value
padval = cdflib.getVarPadValue(cdfId,varNum)
padval =

  int8

   1
%Clean up
cdflib.delete(cdfId)
clear cdfId

References

This function corresponds to the CDF library C API routine CDFsetzVarPadValue.

To use this function, you must be familiar with the CDF C interface. You can access the CDF documentation at the CDF website.