rename upstream-man-pages to upstream-doc
[clinton/guile-figl.git] / upstream-doc / manglsl / length.xml
CommitLineData
7faf1d71
AW
1<?xml version="1.0" encoding="UTF-8"?>\r
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"\r
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">\r
4<refentry id="length">\r
5 <refmeta>\r
6 <refmetainfo>\r
7 <copyright>\r
8 <year>2011</year>\r
9 <holder>Khronos Group</holder>\r
10 </copyright>\r
11 </refmetainfo>\r
12 <refentrytitle>length</refentrytitle>\r
13 <manvolnum>3G</manvolnum>\r
14 </refmeta>\r
15 <refnamediv>\r
16 <refname>length</refname>\r
17 <refpurpose>calculate the length of a vector</refpurpose>\r
18 </refnamediv>\r
19 <refsynopsisdiv><title>Declaration</title>\r
20 <funcsynopsis>\r
21 <funcprototype>\r
22 <funcdef>float <function>length</function></funcdef>\r
23 <paramdef>genType <parameter>x</parameter></paramdef>\r
24 </funcprototype>\r
25 <funcprototype>\r
26 <funcdef>double <function>length</function></funcdef>\r
27 <paramdef>genDType <parameter>x</parameter></paramdef>\r
28 </funcprototype>\r
29 </funcsynopsis>\r
30 </refsynopsisdiv>\r
31 <refsect1 id="parameters"><title>Parameters</title>\r
32 <variablelist>\r
33 <varlistentry>\r
34 <term><parameter>x</parameter></term>\r
35 <listitem>\r
36 <para>\r
37 Specifies a vector of which to calculate the length.\r
38 </para>\r
39 </listitem>\r
40 </varlistentry>\r
41 </variablelist>\r
42 </refsect1>\r
43 <refsect1 id="description"><title>Description</title>\r
44 <para>\r
45 <function>length</function> returns the length of the vector. i.e.,\r
46 <inlineequation><mml:math>\r
47 <mml:apply>\r
48 <mml:root/>\r
49 <mml:csymbol>\r
50 <mml:msup>\r
51 <mml:mrow>\r
52 <mml:mi>x</mml:mi><mml:mo stretchy='false'>[</mml:mo><mml:mn>0</mml:mn><mml:mo stretchy='false'>]</mml:mo>\r
53 </mml:mrow>\r
54 <mml:mn>2</mml:mn>\r
55 </mml:msup>\r
56 <mml:mo>+</mml:mo>\r
57 <mml:msup>\r
58 <mml:mrow>\r
59 <mml:mi>x</mml:mi><mml:mo stretchy='false'>[</mml:mo><mml:mn>1</mml:mn><mml:mo stretchy='false'>]</mml:mo>\r
60 </mml:mrow>\r
61 <mml:mn>2</mml:mn>\r
62 </mml:msup>\r
63 <mml:mo>+</mml:mo>\r
64 <mml:mo lspace='0px' form='infix'>...</mml:mo>\r
65 </mml:csymbol>\r
66 </mml:apply>\r
67 </mml:math></inlineequation>\r
68 </para>\r
69 </refsect1>\r
70 <refsect1 id="versions"><title>Version Support</title>\r
71 <informaltable frame="topbot">\r
72 #VARTABLECOLS#\r
73 <thead>\r
74 #FUNCTABLEHEADER#\r
75 <row>\r
76 <entry>length (genType)</entry>#newin11#\r
77 </row>\r
78 <row>\r
79 <entry>length (genDType)</entry>#newin40#\r
80 </row>\r
81 </thead>\r
82 </tgroup>\r
83 </informaltable>\r
84 </refsect1>\r
85 <refsect1 id="seealso"><title>See Also</title>\r
86 <para>\r
87 <citerefentry><refentrytitle>distance</refentrytitle></citerefentry>,\r
88 <citerefentry><refentrytitle>normalize</refentrytitle></citerefentry>\r
89 </para>\r
90 </refsect1>\r
91 <refsect1 id="Copyright"><title>Copyright</title>\r
92 <para>\r
93 Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
94 This material may be distributed subject to the terms and conditions set forth in \r
95 the Open Publication License, v 1.0, 8 June 1999.\r
96 <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
97 </para>\r
98 </refsect1>\r
99</refentry>\r