vsinpi_(3mvec)

1vsinpi_(3MVEC)           Vector Math Library Functions          vsinpi_(3MVEC)
2
3
4

NAME

6       vsinpi_, vsinpif_ - vector sinpi functions
7

SYNOPSIS

9       cc [ flag... ] file... -lmvec [ library... ]
10
11       void vsinpi_(int *n, double * restrict x, int *stridex,
12            double * restrict y, int *stridey);
13
14
15       void vsinpif_(int *n, float * restrict x, int *stridex,
16            float * restrict y, int *stridey);
17
18

DESCRIPTION

20       These  functions  evaluate the function sinpi(x), defined by sinpi(x) =
21       sin(pi * x), for an entire vector of values at once. The first  parame‐
22       ter  specifies  the  number of values to compute. Subsequent parameters
23       specify the argument and result vectors. Each vector is described by  a
24       pointer  to  the  first  element  and  a stride, which is the increment
25       between successive elements.
26
27
28       Specifically, vsinpi_(n, x, sx, y, sy) computes y[i * *sy] =  sinpi(x[i
29       *  *sx])  for  each i = 0, 1, ..., *n - 1. The vsinpif_() function per‐
30       forms the same computation for single precision data.
31
32
33       Non-exceptional results are accurate to  within  a  unit  in  the  last
34       place.
35

USAGE

37       The  element  count  *n  must be greater than zero. The strides for the
38       argument and result arrays can be arbitrary integers,  but  the  arrays
39       themselves  must  not be the same or overlap. A zero stride effectively
40       collapses an entire vector into a single  element.  A  negative  stride
41       causes  a  vector  to  be accessed in descending memory order, but note
42       that the corresponding pointer must still point to the first element of
43       the  vector  to  be  used;  if the stride is negative, this will be the
44       highest-addressed element in memory. This convention differs  from  the
45       Level  1  BLAS,  in  which array parameters always refer to the lowest-
46       addressed element in memory even when negative increments are used.
47
48
49       These functions  assume  that  the  default  round-to-nearest  rounding
50       direction  mode  is in effect. On x86, these functions also assume that
51       the default round-to-64-bit rounding precision mode is in  effect.  The
52       result of calling a vector function with a non-default rounding mode in
53       effect is undefined.
54
55
56       These functions handle special cases and exceptions in  the  spirit  of
57       IEEE 754. In particular,
58
59           o      sinpi(NaN) is NaN,
60
61           o      sinpi(±0) is ±0,
62
63           o      sinpi(±Inf)  is  NaN,  and an invalid operation exception is
64                  raised.
65
66
67       An application wanting to check for exceptions should  call  feclearex‐
68       cept(FE_ALL_EXCEPT)  before  calling  these  functions.  On  return, if
69       fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is
70       non-zero,  an exception has been raised. The application can then exam‐
71       ine the result or argument vectors for exceptional values. Some  vector
72       functions  can  raise the inexact exception even if all elements of the
73       argument array are such that the numerical results are exact.
74

ATTRIBUTES

76       See attributes(5) for descriptions of the following attributes:
77
78
79
80
81       ┌─────────────────────────────┬─────────────────────────────┐
82       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
83       ├─────────────────────────────┼─────────────────────────────┤
84       │Interface Stability          │Committed                    │
85       ├─────────────────────────────┼─────────────────────────────┤
86       │MT-Level                     │MT-Safe                      │
87       └─────────────────────────────┴─────────────────────────────┘
88

NAME

SYNOPSIS

DESCRIPTION

USAGE

ATTRIBUTES

SEE ALSO