mlib_VectorSplit_U8_U8C(3MmediaLib Library Functmlib_VectorSplit_U8_U8C(3MLIB)NAME
mlib_VectorSplit_U8_U8C, mlib_VectorSplit_S8_S8C, mlib_Vector‐
Split_S16_S16C, mlib_VectorSplit_S32_S32C - vector split
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_VectorSplit_U8_U8C(mlib_u8 *r, mlib_u8 *i,
const mlib_u8 *x, mlib_s32 n);
mlib_status mlib_VectorSplit_S8_S8C(mlib_s8 *r, mlib_s8 *i,
const mlib_s8 *x, mlib_s32 n);
mlib_status mlib_VectorSplit_S16_S16C(mlib_s16 *r, mlib_s16 *i,
const mlib_s16 *x, mlib_s32 n);
mlib_status mlib_VectorSplit_S32_S32C(mlib_s32 *r, mlib_s32 *i,
const mlib_s32 *x, mlib_s32 n);
DESCRIPTION
Each of these functions splits a complex vector into separate vectors
containing the real and imaginary parts.
The following equation is used:
r[k] = z[2*k]
i[k] = z[2*k + 1]
where k = 0, 1, ..., (n - 1).
PARAMETERS
Each of the functions takes the following arguments:
r Pointer to the first element of the real part.
i Pointer to the first element of the imaginary part.
x Pointer to the first complex element of the source vector. x[2*k]
contains the real part, and x[2*k + 1] contains the imaginary
part.
n Number of elements in the vectors.
RETURN VALUES
Each of the functions returns MLIB_SUCCESS if successful. Otherwise it
returns MLIB_FAILURE.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmlib_VectorMerge_U8C_U8(3MLIB), attributes(5)SunOS 5.10 2 Mar 2007 mlib_VectorSplit_U8_U8C(3MLIB)