merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / sbasic / shared / 03080104.xhp
blob3cf56c82d587736b4096fdcd4981a2f6db140c45
1 <?xml version="1.0" encoding="UTF-8"?>
4 <!--
5 ***********************************************************************
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2008 by Sun Microsystems, Inc.
11 * OpenOffice.org - a multi-platform office productivity suite
13 * $RCSfile: 03080104.xhp,v $
14 * $Revision: 1.6 $
16 * This file is part of OpenOffice.org.
18 * OpenOffice.org is free software: you can redistribute it and/or modify
19 * it under the terms of the GNU Lesser General Public License version 3
20 * only, as published by the Free Software Foundation.
22 * OpenOffice.org is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU Lesser General Public License version 3 for more details
26 * (a copy is included in the LICENSE file that accompanied this code).
28 * You should have received a copy of the GNU Lesser General Public License
29 * version 3 along with OpenOffice.org. If not, see
30 * <http://www.openoffice.org/license.html>
31 * for a copy of the LGPLv3 License.
33 ************************************************************************
34 -->
36 <helpdocument version="1.0">
37 <meta>
38 <topic id="textsbasicshared03080104xml" indexer="include" status="PUBLISH">
39 <title id="tit" xml-lang="en-US">Tan Function [Runtime]</title>
40 <filename>/text/sbasic/shared/03080104.xhp</filename>
41 </topic>
42 <history>
43 <created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created>
44 <lastedited date="2006-12-15T09:15:53">converted from old format - fpe</lastedited>
45 </history>
46 </meta>
47 <body>
48 <section id="tan">
49 <bookmark xml-lang="en-US" branch="index" id="bm_id3148550"><bookmark_value>Tan function</bookmark_value>
50 </bookmark>
51 <paragraph role="heading" id="hd_id3148550" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03080104.xhp" name="Tan Function [Runtime]">Tan Function [Runtime]</link></paragraph>
52 <paragraph role="paragraph" id="par_id3148663" xml-lang="en-US" l10n="CHG" oldref="2">Determines the tangent of an angle. The angle is specified in radians.<comment>i71396</comment></paragraph>
53 </section>
54 <paragraph role="paragraph" id="par_id3153379" xml-lang="en-US" l10n="U" oldref="3">Using the angle Alpha, the Tan Function calculates the ratio of the length of the side opposite the angle to the length of the side adjacent to the angle in a right-angled triangle.</paragraph>
55 <paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="4">Tan(Alpha) = side opposite the angle/side adjacent to angle</paragraph>
56 <paragraph role="heading" id="hd_id3145174" xml-lang="en-US" level="2" l10n="U" oldref="5">Syntax:</paragraph>
57 <paragraph role="paragraph" id="par_id3151042" xml-lang="en-US" l10n="U" oldref="6">Tan (Number)</paragraph>
58 <paragraph role="heading" id="hd_id3156214" xml-lang="en-US" level="2" l10n="U" oldref="7">Return value:</paragraph>
59 <paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="8">Double</paragraph>
60 <paragraph role="heading" id="hd_id3155132" xml-lang="en-US" level="2" l10n="U" oldref="9">Parameters:</paragraph>
61 <paragraph role="paragraph" id="par_id3145786" xml-lang="en-US" l10n="U" oldref="10">
62 <emph>Number:</emph> Any numeric expression that you want to calculate the tangent for (in radians).</paragraph>
63 <paragraph role="paragraph" id="par_id3153728" xml-lang="en-US" l10n="U" oldref="11">To convert degrees to radians, multiply by Pi/180. To convert radians to degrees, multiply by 180/Pi.</paragraph>
64 <paragraph role="paragraph" id="par_id3155414" xml-lang="en-US" l10n="CHG" oldref="12">degrees=(radiant*180)/Pi</paragraph>
65 <paragraph role="paragraph" id="par_id3146975" xml-lang="en-US" l10n="CHG" oldref="13">radiant=(degrees*Pi)/180</paragraph>
66 <paragraph role="paragraph" id="par_id3147434" xml-lang="en-US" l10n="U" oldref="14">Pi is approximately 3.141593.</paragraph>
67 <embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
68 <embed href="text/sbasic/shared/00000003.xhp#err5"/>
69 <paragraph role="heading" id="hd_id3149483" xml-lang="en-US" level="2" l10n="U" oldref="15">Example:</paragraph>
70 <paragraph role="paragraph" id="par_id3148646" xml-lang="en-US" l10n="U" oldref="16">REM In this example, the following entry is possible for a right-angled triangle:</paragraph>
71 <paragraph role="paragraph" id="par_id3150012" xml-lang="en-US" l10n="U" oldref="17">REM The side opposite the angle and the angle (in degrees) to calculate the length of the side adjacent to the angle:</paragraph>
72 <paragraph role="paragraph" id="par_id3151115" xml-lang="en-US" l10n="U" oldref="18">Sub ExampleTangens</paragraph>
73 <paragraph role="paragraph" id="par_id3153158" xml-lang="en-US" l10n="U" oldref="19">REM Pi = 3.1415926 is a pre-defined variable</paragraph>
74 <paragraph role="paragraph" id="par_id3145800" xml-lang="en-US" l10n="U" oldref="20">Dim d1 as Double</paragraph>
75 <paragraph role="paragraph" id="par_id3150417" xml-lang="en-US" l10n="U" oldref="21">Dim dAlpha as Double</paragraph>
76 <paragraph role="paragraph" id="par_id3145252" xml-lang="en-US" l10n="U" oldref="22">d1 = InputBox$ ("Enter the length of the side opposite the angle: ","opposite")</paragraph>
77 <paragraph role="paragraph" id="par_id3149582" xml-lang="en-US" l10n="U" oldref="23">dAlpha = InputBox$ ("Enter the Alpha angle (in degrees): ","Alpha")</paragraph>
78 <paragraph role="paragraph" id="par_id3154016" xml-lang="en-US" l10n="U" oldref="24">Print "the length of the side adjacent the angle is"; (d1 / tan (dAlpha * Pi / 180))</paragraph>
79 <paragraph role="paragraph" id="par_id3154731" xml-lang="en-US" l10n="U" oldref="25">End Sub</paragraph>
80 </body>
81 </helpdocument>