nitfReadMetaMulti.m
d19d4d820af0master

nitfReadMetaMulti.m
View Options

			function meta = nitfReadMetaMulti(meta, fieldsTable, fid, index)
			%nitfReadMetaMulti Append attributes to metadata structure.
			% OUTMETA = nitfReadMetaMulti(INMETA, FIELDSTABLE, FID, INDEX) reads
			% attributes from the file with handle FID and append it to INMETA the
			% metadata structure. The FIELDSTABLE cell array contains details
			% about the attributes, such as short names, long names, and data
			% length. Unlike nitfReadMeta() the .name and .vname fields are
			% templates with sprintf() patterns.

			% Copyright 2008 The MathWorks, Inc.

			% For the sake of performance, pre-allocate storage for the new
			% attributes and then insert attributes into the pre-sized struct array.
			% Use "offset" to facilitate adding the new attributes.
			metaOffset = numel(meta);
			numToAppend = size(fieldsTable, 1);

			meta(metaOffset + numToAppend).value = '';

			% As an optimization, convert the lengths part of the cell array to a
			% numeric array.
			dataLengths = [fieldsTable{:,3}];

			% Read all of the data at once. Extract individual values in the loop.
			data = fread(fid, sum(dataLengths), 'uint8=>char')';

			% Insert the new attributes.
			dataOffset = 0;
			for p = 1:numToAppend

			start = dataOffset + 1;
			stop = dataOffset + dataLengths(p);

			meta(metaOffset + p).name = sprintf(fieldsTable{p,1}, index);
			meta(metaOffset + p).vname = sprintf(fieldsTable{p,2}, index);
			meta(metaOffset + p).value = data(start:stop);

			dataOffset = stop;

			end