PRTools contents |
GETIDENT
IDENTFIELD = GETIDENT(A,FIELD,L)
Input | |
A | Dataset |
FIELD | Character string: name of structure field of IDENT field of A. |
L | Vector of indices pointing to desired objects in A, default: all. |
Output | |
IDENTFIELD | Cell array of size (L,1) containing the requested field of the objects A(L,:). |
Note the ident field of datasets was originally intended for an identification of the individual objects. Later its usage was extended to a field for storing general information on objects. For that reason 'old' datasets without a structure in the ident field are transformed such that this information is stored in a subfield IDENT in the ident field. It can be retrieved by GETIDENT(A) or GETIDENT(A,J).
IDENTFIELD is a cell array as arbitrary parameters may be stored. If these are doubles, e.g. after A = SETIDENT(A,[1:SIZE(A,1)]'), they can be easily converted by N = CELL2MAT(GETIDENT(A));
For backward compatibility the following holds: If FIELD = 'string' then IDENTFIELD contains a character array of the object identifiers stored in A.IDENT.IDENT. If these are integers they are converted to strings.
PRTools contents |