Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
Contents

GetStatusString

Translates a status code into a message.

Syntax

const char* ippGetStatusString(IppStatus
stsCode
);
Include Files
ippcore.h
Parameters
stsCode
Code that indicates the status type (see Error Status Values and Messages).
Description
This function returns a pointer to the text string associated with a status code of
IppStatus
type . Use this function to produce error and warning messages for users. The returned pointer is a pointer to an internal static buffer and does not need to be released.

Example

The following code example shows how to use the function
ippGetStatusString
. If you call an Intel IPP function
ippsAddC_16s_I
with a
NULL
pointer, it returns an error code
-8
. The status information function translates this code into the corresponding message
“Null Pointer Error”
.
void statusinfo(void) { IppStatus st = ippsAddC_16s_I (3, 0, 0); printf(“%d : %s\n”, st, ippGetStatusString(st)); }
Output:
-8, Null Pointer Error

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804