Name | Synopsis | Description | Parameters | Return Values | Attributes | See Also
cc [ flag... ] file... -lmlib [ library... ] #include <mlib.h> mlib_status mlib_MatrixUnit_U8(mlib_u8 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_U8C(mlib_u8 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_S8(mlib_s8 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_S8C(mlib_s8 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_S16(mlib_s16 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_S16C(mlib_s16 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_S32(mlib_s32 *z, mlib_s32 n);
mlib_status mlib_MatrixUnit_S32C(mlib_s32 *z, mlib_s32 n);
Each of these functions sets the values for a unit matrix.
For real data, the following equation is used:
z[i*n + j] = 1 if i == j z[i*n + j] = 0 if i != j
where i = 0, 1, ..., (n - 1); j = 0, 1, ..., (n - 1).
For complex data, the following equation is used:
z[2*(i*n + j)] = 1 if i == j z[2*(i*n + j)] = 0 if i != j z[2*(i*n + j) + 1] = 0
where i = 0, 1, ..., (n - 1); j = 0, 1, ..., (n - 1).
Each of the functions takes the following arguments:
Pointer to the destination matrix.
Number of rows and columns in the matrix.
Each of the functions returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Interface Stability |
Committed |
MT-Level |
MT-Safe |
Name | Synopsis | Description | Parameters | Return Values | Attributes | See Also