Skip to content

Commit 8649ed2

Browse files
TylerMSFTTylerMSFT
authored andcommitted
add ofuncs
1 parent da8a3f2 commit 8649ed2

17 files changed

+281
-289
lines changed

docs/c-runtime-library/internal-crt-globals-and-functions.md

Lines changed: 3 additions & 1 deletion
Large diffs are not rendered by default.

docs/c-runtime-library/reference/acos-acosf-acosl.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,15 @@
11
---
22
title: "acos, acosf, acosl"
33
description: "API reference for `acos`, `acosf`, and `acosl`; which calculate the arccosine of a floating-point value."
4-
ms.date: "08/31/2020"
5-
api_name: ["acosf", "acos", "acosl", "_o_acos"]
4+
ms.date: "1/15/2021"
5+
api_name: ["acosf", "acos", "acosl", "_o_acos", "_o_acosf"]
66
api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll", "api-ms-win-crt-private-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["acos", "acosl", "acosf", "math/acosf", "math/acosl"]
1010
helpviewer_keywords: ["acos function", "acosl function", "acosf function", "trigonometric functions", "arccosine function"]
11-
ms.assetid: 00b89c48-8faf-4824-aa95-fa4349a4975d
1211
---
13-
# acos, acosf, acosl
12+
# `acos`, `acosf`, `acosl`
1413

1514
Calculates the arccosine.
1615

@@ -28,14 +27,14 @@ long double acos( long double x ); // C++ only
2827
2928
### Parameters
3029
31-
*x*\
30+
*`x`*\
3231
Value between -1 and 1, for which to calculate the arccosine (the inverse cosine).
3332
3433
## Return Value
3534
36-
The **acos** function returns the arccosine of *x* in the range 0 to π radians.
35+
The **`acos`** function returns the arccosine of *x* in the range 0 to π radians.
3736
38-
By default, if *x* is less than -1 or greater than 1, **acos** returns an indefinite.
37+
By default, if *x* is less than -1 or greater than 1, **`acos`** returns an indefinite.
3938
4039
|Input|SEH Exception|Matherr Exception|
4140
|-----------|-------------------|-----------------------|
@@ -45,18 +44,18 @@ By default, if *x* is less than -1 or greater than 1, **acos** returns an indefi
4544
4645
## Remarks
4746
48-
Because C++ allows overloading, you can call overloads of **acos** that take and return **`float`** and **`long double`** types. In a C program, unless you're using the \<tgmath.h> macro to call this function, **acos** always takes and returns a **`double`**.
47+
Because C++ allows overloading, you can call overloads of **`acos`** that take and return **`float`** and **`long double`** types. In a C program, unless you're using the `<tgmath.h>` macro to call this function, **acos** always takes and returns a **`double`**.
4948
50-
If you use the \<tgmath.h> `acos()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
49+
If you use the `<tgmath.h>` `acos()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
5150
5251
By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
5352
5453
## Requirements
5554
5655
|Routine|Required header|Optional headers|
5756
|-------------|---------------------|----------------------|
58-
|**acos**, **acosf**, **acosl**|\<math.h>|\<errno.h>|
59-
|**acos()** macro | \<tgmath.h> ||
57+
|**`acos`**, **`acosf`**, **`acosl`**|`<math.h>`|`<errno.h>`|
58+
|**`acos()`** macro | `<tgmath.h>` ||
6059
6160
## Example
6261
@@ -110,10 +109,10 @@ Arccosine of 0.000000 = 1.570796
110109

111110
## See also
112111

113-
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)<br/>
114-
[asin, asinf, asinl](asin-asinf-asinl.md)<br/>
115-
[atan, atanf, atanl, atan2, atan2f, atan2l](atan-atanf-atanl-atan2-atan2f-atan2l.md)<br/>
116-
[cos, cosf, cosl](cos-cosf-cosl.md)<br/>
117-
[_matherr](matherr.md)<br/>
118-
[sin, sinf, sinl](sin-sinf-sinl.md)<br/>
119-
[tan, tanf, tanl](tan-tanf-tanl.md)
112+
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)\
113+
[`asin`, `asinf`, `asinl`](asin-asinf-asinl.md)\
114+
[`atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`](atan-atanf-atanl-atan2-atan2f-atan2l.md)\
115+
[`cos`, `cosf`, `cosl`](cos-cosf-cosl.md)\
116+
[`_matherr`](matherr.md)\
117+
[`sin`, `sinf`, `sinl`](sin-sinf-sinl.md)\
118+
[`tan`, `tanf`, `tanl`](tan-tanf-tanl.md)
Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,15 @@
11
---
22
title: "asin, asinf, asinl"
33
description: "API reference for asin, asinf, and asinl; which calculate the arcsine of a floating-point value."
4-
ms.date: "08/31/2020"
5-
api_name: ["asinf", "asinl", "asin", "_o_asin"]
4+
ms.date: "1/15/2021"
5+
api_name: ["asinf", "asinl", "asin", "_o_asin", "_o_asinf"]
66
api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll", "api-ms-win-crt-private-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["asin", "asinl", "asinf"]
1010
helpviewer_keywords: ["asin function", "asinl function", "asinf function", "trigonometric functions", "arcsine function"]
11-
ms.assetid: ca05f9ea-b711-49f6-9f32-2f4019abfd69
1211
---
13-
# asin, asinf, asinl
12+
# `asin`, `asinf`, `asinl`
1413

1514
Calculates the arcsine.
1615

@@ -28,46 +27,46 @@ long double asin( long double x ); // C++ only
2827
2928
### Parameters
3029
31-
*x*\
30+
*`x`*\
3231
Value whose arcsine is to be calculated.
3332
3433
## Return Value
3534
36-
The **asin** function returns the arcsine (the inverse sine function) of *x* in the range -π/2 to π/2 radians.
35+
The **`asin`** function returns the arcsine (the inverse sine function) of *`x`* in the range -π/2 to π/2 radians.
3736
38-
By default, if *x* is less than -1 or greater than 1, **asin** returns an indefinite.
37+
By default, if *`x`* is less than -1 or greater than 1, **`asin`** returns an indefinite.
3938
4039
|Input|SEH Exception|Matherr Exception|
4140
|-----------|-------------------|-----------------------|
42-
|± ∞|**INVALID**|**_DOMAIN**|
43-
|± **QNAN**, **IND**|none|**_DOMAIN**|
44-
|&#124;x&#124;>1|**INVALID**|**_DOMAIN**|
41+
|± ∞|**`INVALID`**|**`_DOMAIN`**|
42+
|± **`QNAN`**, **`IND`**|none|**`_DOMAIN`**|
43+
|&#124;x&#124;>1|**`INVALID`**|**`_DOMAIN`**|
4544
4645
## Remarks
4746
48-
Because C++ allows overloading, you can call overloads of **asin** with **`float`** and **`long double`** values. In a C program, unless you're using the \<tgmath.h> macro to call this function, **asin** always takes and returns a **`double`**.
47+
Because C++ allows overloading, you can call overloads of **`asin`** with **`float`** and **`long double`** values. In a C program, unless you're using the `<tgmath.h>` macro to call this function, **`asin`** always takes and returns a **`double`**.
4948
50-
If you use the \<tgmath.h> `asin()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
49+
If you use the `<tgmath.h>` `asin()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
5150
5251
By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
5352
5453
## Requirements
5554
5655
|Routine|Required header (C)|Required header (C++)|
5756
|-------------|---------------------|-|
58-
|**asin**, **asinf**, **asinl**|\<math.h>|\<cmath> or \<math.h>|
59-
|**asin()** macro | \<tgmath.h> ||
57+
|**`asin`**, **`asinf`**, **`asinl`**|`<math.h>`|`<cmath>` or `<math.h>`|
58+
|**`asin()`** macro | `<tgmath.h>` ||
6059
6160
## Example
6261
63-
For more information, see [acos, acosf, acosl](acos-acosf-acosl.md).
62+
For more information, see [`acos`, `acosf`, `acosl`](acos-acosf-acosl.md).
6463
6564
## See also
6665
67-
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)<br/>
68-
[acos, acosf, acosl](acos-acosf-acosl.md)<br/>
69-
[atan, atanf, atanl, atan2, atan2f, atan2l](atan-atanf-atanl-atan2-atan2f-atan2l.md)<br/>
70-
[cos, cosf, cosl](cos-cosf-cosl.md)<br/>
71-
[_matherr](matherr.md)<br/>
72-
[sin, sinf, sinl](sin-sinf-sinl.md)<br/>
73-
[tan, tanf, tanl](tan-tanf-tanl.md)<br/>
66+
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)\
67+
[`acos`, `acosf`, `acosl`](acos-acosf-acosl.md)\
68+
[`atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`](atan-atanf-atanl-atan2-atan2f-atan2l.md)\
69+
[`cos`, `cosf`, `cosl`](cos-cosf-cosl.md)\
70+
[`_matherr`](matherr.md)\
71+
[`sin`, `sinf`, si`nl](sin-sinf-sinl.md)\
72+
[`tan`, `tanf`, `tanl`](tan-tanf-tanl.md)

docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md

Lines changed: 23 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
22
title: "atan, atanf, atanl, atan2, atan2f, atan2l"
33
description: "API reference for atan, atanf, atanl, atan2, atan2f, and atan2l; which calculate the arctangent of a floating-point value."
4-
ms.date: "08/31/2020"
5-
api_name: ["atan2f", "atan2l", "atan2", "atanf", "atan", "atanl", "_o_atan", "_o_atan2", "_o_atan2f"]
4+
ms.date: "1/15/2021"
5+
api_name: ["atan2f", "atan2l", "atan2", "atanf", "atan", "atanl", "_o_atan", "_o_atan2", "_o_atan2f", "_o_atanf"]
66
api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll", "api-ms-win-crt-private-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["atan", "atan2l", "atan2", "atanl", "atanf", "atan2f"]
1010
helpviewer_keywords: ["atan function", "atanf function", "atanl function", "atan2 function", "atan2l function", "arctangent function", "trigonometric functions", "atan2f function"]
11-
ms.assetid: 7a87a18e-c94d-4727-9cb1-1bb5c2725ae4
1211
---
13-
# atan, atanf, atanl, atan2, atan2f, atan2l
12+
# `atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`
1413

15-
Calculates the arctangent of **x** (**atan**, **atanf**, and **atanl**) or the arctangent of **y**/**x** (**atan2**, **atan2f**, and **atan2l**).
14+
Calculates the arctangent of **`x`** (**`atan`**, **`atanf`**, and **`atanl`**) or the arctangent of **`y`**/**`x`** (**`atan2`**, **`atan2f`**, and **`atan2l`**).
1615

1716
## Syntax
1817

@@ -36,37 +35,37 @@ long double atan2( long double y, long double x ); // C++ only
3635
3736
### Parameters
3837
39-
*x*, *y*\
38+
*`x`*, *`y`*\
4039
Any numbers.
4140
4241
## Return Value
4342
44-
**atan** returns the arctangent of *x* in the range -π/2 to π/2 radians. **atan2** returns the arctangent of *y*/*x* in the range -π to π radians. If *x* is 0, **atan** returns 0. If both parameters of **atan2** are 0, the function returns 0. All results are in radians.
43+
**`atan`** returns the arctangent of *`x`* in the range -π/2 to π/2 radians. **`atan2`** returns the arctangent of *`y`*/*`x`* in the range -π to π radians. If *`x`* is 0, **`atan`** returns 0. If both parameters of **`atan2`** are 0, the function returns 0. All results are in radians.
4544
46-
**atan2** uses the signs of both parameters to determine the quadrant of the return value.
45+
**`atan2`** uses the signs of both parameters to determine the quadrant of the return value.
4746
4847
|Input|SEH Exception|Matherr Exception|
4948
|-----------|-------------------|-----------------------|
50-
|± **QNAN**, **IND**|none|**_DOMAIN**|
49+
|± **`QNAN`**, **`IND`**|none|**`_DOMAIN`**|
5150
5251
## Remarks
5352
54-
The **atan** function calculates the arctangent (the inverse tangent function) of *x*. **atan2** calculates the arctangent of *y*/*x* (if *x* equals 0, **atan2** returns π/2 if *y* is positive, -π/2 if *y* is negative, or 0 if *y* is 0.)
53+
The **`atan`** function calculates the arctangent (the inverse tangent function) of *`x`*. **`atan2`** calculates the arctangent of *`y`*/*`x`* (if *`x`* equals 0, **`atan2`** returns π/2 if *`y`* is positive, -π/2 if *`y`* is negative, or 0 if *`y`* is 0.)
5554
56-
If you use the \<tgmath.h> `atan()` or `atan2()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
55+
If you use the `<tgmath.h>` `atan()` or `atan2()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
5756
58-
**atan** has an implementation that uses Streaming SIMD Extensions 2 (SSE2). For information and restrictions about using the SSE2 implementation, see [_set_SSE2_enable](set-sse2-enable.md).
57+
**`atan`** has an implementation that uses Streaming SIMD Extensions 2 (SSE2). For information and restrictions about using the SSE2 implementation, see [`_set_SSE2_enable`](set-sse2-enable.md).
5958
60-
Because C++ allows overloading, you can call overloads of **atan** and **atan2** that take **`float`** or **`long double`** arguments. In a C program, unless you're using the \<tgmath.h> macro to call this function, **atan** and **atan2** always take **`double`** arguments and return a **`double`**.
59+
Because C++ allows overloading, you can call overloads of **`atan`** and **`atan2`** that take **`float`** or **`long double`** arguments. In a C program, unless you're using the `<tgmath.h>` macro to call this function, **`atan`** and **`atan2`** always take **`double`** arguments and return a **`double`**.
6160
6261
By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
6362
6463
## Requirements
6564
6665
|Routine|Required header (C)|Required header (C++)|
6766
|-------------|---------------------|-|
68-
|**atan**, **atan2**, **atanf**, **atan2f**, **atanl**, **atan2l**|\<math.h>|\<cmath> or \<math.h>|
69-
|**atan()**, **atan2** macros | \<tgmath.h> ||
67+
|**`atan`**, **`atan2`**, **`atanf`**, **`atan2f`**, **`atanl`**, **`atan2l`**|`<math.h>`|`<cmath>` or `<math.h>`|
68+
|**`atan()`**, **`atan2`** macros | `<tgmath.h>` ||
7069
7170
## Example
7271
@@ -101,12 +100,12 @@ Arctangent of 0.500000 / 5.000000: 0.099669
101100

102101
## See also
103102

104-
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)<br/>
105-
[acos, acosf, acosl](acos-acosf-acosl.md)<br/>
106-
[asin, asinf, asinl](asin-asinf-asinl.md)<br/>
107-
[cos, cosf, cosl](cos-cosf-cosl.md)<br/>
108-
[_matherr](matherr.md)<br/>
109-
[sin, sinf, sinl](sin-sinf-sinl.md)<br/>
110-
[tan, tanf, tanl](tan-tanf-tanl.md)<br/>
111-
[_CIatan](../../c-runtime-library/ciatan.md)<br/>
112-
[_CIatan2](../../c-runtime-library/ciatan2.md)<br/>
103+
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)\
104+
[`acos`, `acosf`, `acosl`](acos-acosf-acosl.md)\
105+
[`asin`, `asinf`, `asinl`](asin-asinf-asinl.md)\
106+
[`cos`, `cosf`, `cosl`](cos-cosf-cosl.md)\
107+
[`_matherr`](matherr.md)\
108+
[`sin`, `sinf`, `sinl`](sin-sinf-sinl.md)\
109+
[`tan`, `tanf`, `tanl`](tan-tanf-tanl.md)\
110+
[`_CIatan`](../../c-runtime-library/ciatan.md)\
111+
[`_CIatan2`](../../c-runtime-library/ciatan2.md)
Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
title: "cosh, coshf, coshl"
33
description: "API reference for cosh, coshf, and coshl; which calculate the hyperbolic cosine of a floating-point value."
4-
ms.date: "08/31/2020"
5-
api_name: ["cosh", "coshf", "coshl", "_o_cosh"]
4+
ms.date: "1/15/2021"
5+
api_name: ["cosh", "coshf", "coshl", "_o_cosh", "_o_coshf"]
66
api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll", "api-ms-win-crt-private-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["cosh", "coshf", "coshl"]
1010
helpviewer_keywords: ["cosh function", "coshf function", "coshl function", "trigonometric functions", "hyperbolic functions"]
1111
---
12-
# cosh, coshf, coshl
12+
# `cosh`, `coshf`, `coshl`
1313

1414
Calculates the hyperbolic cosine.
1515

@@ -27,47 +27,47 @@ long double cosh( long double x ); // C++ only
2727
2828
### Parameters
2929
30-
*x*\
30+
*`x`*\
3131
Angle in radians.
3232
3333
## Return Value
3434
35-
The hyperbolic cosine of *x*.
35+
The hyperbolic cosine of *`x`*.
3636
37-
By default, if the result is too large in a **cosh**, **coshf**, or **coshl** call, the function returns **HUGE_VAL** and sets **errno** to **ERANGE**.
37+
By default, if the result is too large in a **`cosh`**, **`coshf`**, or **`coshl`** call, the function returns **`HUGE_VAL`** and sets **`errno`** to **`ERANGE`**.
3838
3939
|Input|SEH Exception|Matherr Exception|
4040
|-----------|-------------------|-----------------------|
41-
|± **QNAN**, **IND**|none|**_DOMAIN**|
42-
|*x* ≥ 7.104760e+002|**INEXACT**+**OVERFLOW**|**OVERFLOW**|
41+
|± **`QNAN`**, **`IND`**|none|**`_DOMAIN`**|
42+
|*`x`* ≥ 7.104760e+002|**`INEXACT`**+**`OVERFLOW`**|**`OVERFLOW`**|
4343
4444
## Remarks
4545
46-
Because C++ allows overloading, you can call overloads of **cosh** that take and return **`float`** or **`long double`** values. In a C program, unless you're using the \<tgmath.h> macro to call this function, **cosh** always takes and returns a **`double`**.
46+
Because C++ allows overloading, you can call overloads of **`cosh`** that take and return **`float`** or **`long double`** values. In a C program, unless you're using the `<tgmath.h>` macro to call this function, **`cosh`** always takes and returns a **`double`**.
4747
48-
If you use the \<tgmath.h> `cosh()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
48+
If you use the `<tgmath.h>` `cosh()` macro, the type of the argument determines which version of the function is selected. See [Type-generic math](../../c-runtime-library/tgmath.md) for details.
4949
5050
By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
5151
5252
## Requirements
5353
5454
|Routine|Required header (C)|Required header (C++)|
5555
|-------------|---------------------|-|
56-
|**coshf**, **cosl**, **coshl**|\<math.h>|\<cmath> or \<math.h>|
57-
|**coshf()** macro | \<tgmath.h> ||
56+
|**`coshf`**, **`cosl`**, **`coshl`**|`<math.h>`|`<cmath>` or `<math.h>`|
57+
|**`coshf()`** macro | `<tgmath.h>` ||
5858
59-
For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
59+
For more compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
6060
6161
## Example
6262
63-
See the example in [sinh, sinhf, sinhl](sinh-sinhf-sinhl.md).
63+
See the example in [`sinh`, `sinhf`, `sinhl`](sinh-sinhf-sinhl.md).
6464
6565
## See also
6666
67-
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)<br/>
68-
[acosh, acoshf, acoshl](acosh-acoshf-acoshl.md)<br/>
69-
[asinh, asinhf, asinhl](asinh-asinhf-asinhl.md)<br/>
70-
[atanh, atanhf, atanhl](atanh-atanhf-atanhl.md)<br/>
71-
[_matherr](matherr.md)<br/>
72-
[sinh, sinhf, sinhl](sinh-sinhf-sinhl.md)<br/>
73-
[tanh, tanhf, tanhl](tanh-tanhf-tanhl.md)<br/>
67+
[Floating-Point Support](../../c-runtime-library/floating-point-support.md)\
68+
[`acosh, acoshf, acoshl`](acosh-acoshf-acoshl.md)\
69+
[`asinh, asinhf, asinhl`](asinh-asinhf-asinhl.md)\
70+
[`atanh, atanhf, atanhl`](atanh-atanhf-atanhl.md)\
71+
[`_matherr`](matherr.md)\
72+
[`sinh, sinhf, sinhl`](sinh-sinhf-sinhl.md)\
73+
[`tanh, tanhf, tanhl`](tanh-tanhf-tanhl.md)

0 commit comments

Comments
 (0)