Content-type: text/html Man page of mlib_VectorSplit_U8_U8C

# mlib_VectorSplit_U8_U8C

Section: mediaLib Library Functions (3MLIB)
Updated: 2 Mar 2007

## NAME

mlib_VectorSplit_U8_U8C, mlib_VectorSplit_S8_S8C, mlib_VectorSplit_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

mlib_VectorMerge_U8C_U8(3MLIB), attributes(5)

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUES
ATTRIBUTES