#import <NetcdfMutableDimension.h>
Public Member Functions | |
| (id) | - createByOwner:fromSchema: |
| Creates a new dimension in the data set. | |
| (NSString *) | - renameAs:error: |
| Modifies the name of the dimension. | |
NetCDF dimensions may be created or renamed. There is no direct way to alter the length of a dimension or to delete it from the dataset; the only way is to create a new dataset with the altered dimensions.
| - (id) createByOwner: | (NetcdfDataset *) | newOwner | ||
| fromSchema: | (NSDictionary *) | schema | ||
Creates a new dimension in the data set.
This is an initializer that not only initializes a newly allocated NetcdfDimension, it also creates the new dimension in the underlying netCDF dataset. The dataset must be opened for read/write access. The dataset must be in Define Mode. Normally, this method is only called by the NetcdfDataset that will be the new owner. The owner object coordinates entering and leaving define mode. If the length == NC_UNLIMITED, then the new dimension will be unlimited. Attempting to create multiple unlimited dimensions will cause an error.
On failure, returns an object with isValid = NO and ncErrNo = error code. The owner should extract the error information and release the failed dimension.
| - (NSString *) renameAs: | (NSString *) | newName | ||
| error: | (NSError **) | errorP | ||
Modifies the name of the dimension.
If the new name is longer than the old one, the dataset will be automatically enter and leave Define Mode, which is an expensive operation. Returns a pointer to the new name, which may be recoded.
On error, returns nil and an NSError. If errorP is NULL, no error information will be returned.
1.5.7.1