Rate This Document
Findability
Accuracy
Completeness
Readability

Orc

Performs bitwise OR between a constant and each element of a vector.

The function interface declaration is as follows:

  • Operations on integers:

    HmppResult HMPPS_OrC_8u(const uint8_t *src, uint8_t val, uint8_t *dst, int32_t len);

    HmppResult HMPPS_OrC_16u(const uint16_t *src, uint16_t val, uint16_t *dst, int32_t len);

    HmppResult HMPPS_OrC_32u(const uint32_t *src, uint32_t val, uint32_t *dst, int32_t len);

  • In-place operations on integers:

    HmppResult HMPPS_OrC_8u_I(const uint8_t val, uint8_t *srcDst, int32_t len);

    HmppResult HMPPS_OrC_16u_I(const uint16_t val, uint16_t *srcDst, int32_t len);

    HmppResult HMPPS_OrC_32u_I(const uint32_t val, uint32_t *srcDst, int32_t len);

Parameters

Parameter

Description

Value Range

Input/Output

src

Pointer to the source vector

The value cannot be NULL.

Input

val

Fixed value

Not limited, depending on the type

Input

dst

Pointer to the destination vector

The value cannot be NULL.

Output

srcDst

Pointer to the source vector for in-place operations

The value cannot be NULL.

Input/Output

len

Vector length

(0, INT_MAX]

Input

Return Value

  • Success: HMPP_STS_NO_ERR
  • Failure: An error code is returned.

Error Codes

Error Code

Description

HMPP_STS_NULL_PTR_ERR

The value of src1, src2, dst, or srcDst is NULL.

HMPP_STS_SIZE_ERR

The value of len is less than or equal to 0.

Example

#define BUFFER_SIZE_T 9
void OrCExample()
{
    uint8_t src[BUFFER_SIZE_T] = {123, 145, 210, 99, 123, 145, 255, 132, 156};
    uint8_t dst[BUFFER_SIZE_T] = {};
    uint8_t val = 255;
    int32_t i;
    
    HmppResult result = HMPPS_OrC_8u(src, val, dst, BUFFER_SIZE_T);
    printf("result = %d \ndst =", result);
    if (result != HMPP_STS_NO_ERR) {
        return;
    }

    for (i = 0; i < BUFFER_SIZE_T; i++) {
        printf("%d ", dst[i]);
    }
}

Output:

result = 0
dst = 255 255 255 255 255 255 255 255 255