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

NAME

6       vz_log_, vc_log_ - vector complex logarithm functions
7

SYNOPSIS

9       cc [ flag... ] file... -lmvec [ library... ]
10
11       void vz_log_(int *n, double complex * restrict z,
12            int *stridez, double _complex * restrict w, int *stridew);
13
14
15       void vc_log_(int *n, float complex * restrict z,
16            int *stridez, float complex * restrict w, int *stridew);
17
18

DESCRIPTION

20       These functions evaluate the complex function log(z) for an entire vec‐
21       tor of values at once. The first parameter specifies the number of val‐
22       ues  to  compute. Subsequent parameters specify the argument and result
23       vectors. Each vector is described by a pointer to the first element and
24       a stride, which is the increment between successive elements.
25
26
27       Specifically,  vz_log_(n, z, sz, w, sw) computes w[i * *sw] = log(z[i *
28       *sz]) for each i = 0, 1, ..., *n - 1. The vc_log_()  function  performs
29       the same computation for single precision data.
30
31
32       These  functions are not guaranteed to deliver results that are identi‐
33       cal to the results of the clog(3M) functions given the same arguments.
34

USAGE

36       The element count *n must be greater than zero.  The  strides  for  the
37       argument  and  result  arrays can be arbitrary integers, but the arrays
38       themselves must not be the same or overlap. A zero  stride  effectively
39       collapses  an  entire  vector  into a single element. A negative stride
40       causes a vector to be accessed in descending  memory  order,  but  note
41       that the corresponding pointer must still point to the first element of
42       the vector to be used; if the stride is  negative,  this  will  be  the
43       highest-addressed  element  in memory. This convention differs from the
44       Level 1 BLAS, in which array parameters always  refer  to  the  lowest-
45       addressed element in memory even when negative increments are used.
46
47
48       These  functions  assume  that  the  default  round-to-nearest rounding
49       direction mode is in effect. On x86, these functions also  assume  that
50       the  default  round-to-64-bit rounding precision mode is in effect. The
51       result of calling a vector function with a non-default rounding mode in
52       effect is undefined.
53
54
55       Unlike the c99 clog(3M) functions, the vector complex exponential func‐
56       tions make no attempt to handle special cases and exceptions; they sim‐
57       ply  use textbook formulas to compute a complex exponential in terms of
58       real elementary functions. As a result, these functions can raise  dif‐
59       ferent exceptions and/or deliver different results from clog().
60

ATTRIBUTES

62       See attributes(5) for descriptions of the following attributes:
63
64
65
66
67       ┌─────────────────────────────┬─────────────────────────────┐
68       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
69       ├─────────────────────────────┼─────────────────────────────┤
70       │Interface Stability          │Committed                    │
71       ├─────────────────────────────┼─────────────────────────────┤
72       │MT-Level                     │MT-Safe                      │
73       └─────────────────────────────┴─────────────────────────────┘
74

SEE ALSO

76       clog(3M), attributes(5)
77
78
79
80SunOS 5.11                        14 Dec 2007                   vz_log_(3MVEC)
Impressum