1
- <!-- $Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.47 2001/01/13 18:34:51 petere Exp $ -->
1
+ <!-- $Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.48 2001/01/20 20:59:28 petere Exp $ -->
2
2
3
3
<chapter id="functions">
4
4
<title>Functions and Operators</title>
1274
1274
<entry>to_char(125, '999')</entry>
1275
1275
</row>
1276
1276
<row>
1277
- <entry>to_char(float , text)</entry>
1277
+ <entry>to_char(double precision , text)</entry>
1278
1278
<entry>text</entry>
1279
- <entry>convert float4/float8 to string</entry>
1279
+ <entry>convert real/double precision to string</entry>
1280
1280
<entry>to_char(125.8, '999D9')</entry>
1281
1281
</row>
1282
1282
<row>
1927
1927
</row>
1928
1928
<row>
1929
1929
<entry>date_part(text,timestamp)</entry>
1930
- <entry>float8 </entry>
1930
+ <entry>double precision </entry>
1931
1931
<entry>portion of date</entry>
1932
1932
<entry>date_part('dow',timestamp 'now')</entry>
1933
1933
</row>
1934
1934
<row>
1935
1935
<entry>date_part(text,interval)</entry>
1936
- <entry>float8 </entry>
1936
+ <entry>double precision </entry>
1937
1937
<entry>portion of time</entry>
1938
1938
<entry>date_part('hour',interval '4 hrs 3 mins')</entry>
1939
1939
</row>
2033
2033
<ROW>
2034
2034
<ENTRY> + </ENTRY>
2035
2035
<ENTRY>Translation</ENTRY>
2036
- <ENTRY>'((0,0),(1,1))'::box + '(2.0,0)'::point </ENTRY>
2036
+ <ENTRY>box '((0,0),(1,1))' + point '(2.0,0)'</ENTRY>
2037
2037
</ROW>
2038
2038
<ROW>
2039
2039
<ENTRY> - </ENTRY>
2040
2040
<ENTRY>Translation</ENTRY>
2041
- <ENTRY>'((0,0),(1,1))'::box - '(2.0,0)'::point </ENTRY>
2041
+ <ENTRY>box '((0,0),(1,1))' - point '(2.0,0)'</ENTRY>
2042
2042
</ROW>
2043
2043
<ROW>
2044
2044
<ENTRY> * </ENTRY>
2045
2045
<ENTRY>Scaling/rotation</ENTRY>
2046
- <ENTRY>'((0,0),(1,1))'::box * '(2.0,0)'::point </ENTRY>
2046
+ <ENTRY>box '((0,0),(1,1))' * point '(2.0,0)'</ENTRY>
2047
2047
</ROW>
2048
2048
<ROW>
2049
2049
<ENTRY> / </ENTRY>
2050
2050
<ENTRY>Scaling/rotation</ENTRY>
2051
- <ENTRY>'((0,0),(2,2))'::box / '(2.0,0)'::point </ENTRY>
2051
+ <ENTRY>box '((0,0),(2,2))' / point '(2.0,0)'</ENTRY>
2052
2052
</ROW>
2053
2053
<ROW>
2054
2054
<ENTRY> # </ENTRY>
2063
2063
<ROW>
2064
2064
<ENTRY> ## </ENTRY>
2065
2065
<ENTRY>Point of closest proximity</ENTRY>
2066
- <ENTRY>'(0,0)'::point ## '((2,0),(0,2))'::lseg </ENTRY>
2066
+ <ENTRY>point '(0,0)' ## lseg '((2,0),(0,2))'</ENTRY>
2067
2067
</ROW>
2068
2068
<ROW>
2069
2069
<ENTRY> && </ENTRY>
2070
2070
<ENTRY>Overlaps?</ENTRY>
2071
- <ENTRY>'((0,0),(1,1))'::box && '((0,0),(2,2))'::box </ENTRY>
2071
+ <ENTRY>box '((0,0),(1,1))' && box '((0,0),(2,2))'</ENTRY>
2072
2072
</ROW>
2073
2073
<ROW>
2074
2074
<ENTRY> &< </ENTRY>
2075
2075
<ENTRY>Overlaps to left?</ENTRY>
2076
- <ENTRY>'((0,0),(1,1))'::box &< '((0,0),(2,2))'::box </ENTRY>
2076
+ <ENTRY>box '((0,0),(1,1))' &< box '((0,0),(2,2))'</ENTRY>
2077
2077
</ROW>
2078
2078
<ROW>
2079
2079
<ENTRY> &> </ENTRY>
2080
2080
<ENTRY>Overlaps to right?</ENTRY>
2081
- <ENTRY>'((0,0),(3,3))'::box &> '((0,0),(2,2))'::box </ENTRY>
2081
+ <ENTRY>box '((0,0),(3,3))' &> box '((0,0),(2,2))'</ENTRY>
2082
2082
</ROW>
2083
2083
<ROW>
2084
2084
<ENTRY> <-> </ENTRY>
2085
2085
<ENTRY>Distance between</ENTRY>
2086
- <ENTRY>'((0,0),1)'::circle <-> '((5,0),1)'::circle </ENTRY>
2086
+ <ENTRY>circle '((0,0),1)' <-> circle '((5,0),1)'</ENTRY>
2087
2087
</ROW>
2088
2088
<ROW>
2089
2089
<ENTRY> << </ENTRY>
2090
2090
<ENTRY>Left of?</ENTRY>
2091
- <ENTRY>'((0,0),1)'::circle << '((5,0),1)'::circle </ENTRY>
2091
+ <ENTRY>circle '((0,0),1)' << circle '((5,0),1)'</ENTRY>
2092
2092
</ROW>
2093
2093
<ROW>
2094
2094
<ENTRY> <^ </ENTRY>
2095
2095
<ENTRY>Is below?</ENTRY>
2096
- <ENTRY>'((0,0),1)'::circle <^ '((0,5),1)'::circle </ENTRY>
2096
+ <ENTRY>circle '((0,0),1)' <^ circle '((0,5),1)'</ENTRY>
2097
2097
</ROW>
2098
2098
<ROW>
2099
2099
<ENTRY> >> </ENTRY>
2100
2100
<ENTRY>Is right of?</ENTRY>
2101
- <ENTRY>'((5,0),1)'::circle >> '((0,0),1)'::circle </ENTRY>
2101
+ <ENTRY>circle '((5,0),1)' >> circle '((0,0),1)'</ENTRY>
2102
2102
</ROW>
2103
2103
<ROW>
2104
2104
<ENTRY> >^ </ENTRY>
2105
2105
<ENTRY>Is above?</ENTRY>
2106
- <ENTRY>'((0,5),1)'::circle >^ '((0,0),1)'::circle </ENTRY>
2106
+ <ENTRY>circle '((0,5),1)' >^ circle '((0,0),1)'</ENTRY>
2107
2107
</ROW>
2108
2108
<ROW>
2109
2109
<ENTRY> ?# </ENTRY>
2110
2110
<ENTRY>Intersects or overlaps</ENTRY>
2111
- <ENTRY>'((-1,0),(1,0))'::lseg ?# '((-2,-2),(2,2))'::box ;</ENTRY>
2111
+ <ENTRY>lseg '((-1,0),(1,0))' ?# box '((-2,-2),(2,2))';</ENTRY>
2112
2112
</ROW>
2113
2113
<ROW>
2114
2114
<ENTRY> ?- </ENTRY>
2115
2115
<ENTRY>Is horizontal?</ENTRY>
2116
- <ENTRY>'(1,0)'::point ?- '(0,0)'::point </ENTRY>
2116
+ <ENTRY>point '(1,0)' ?- point '(0,0)'</ENTRY>
2117
2117
</ROW>
2118
2118
<ROW>
2119
2119
<ENTRY> ?-| </ENTRY>
2120
2120
<ENTRY>Is perpendicular?</ENTRY>
2121
- <ENTRY>'((0,0),(0,1))'::lseg ?-| '((0,0),(1,0))'::lseg </ENTRY>
2121
+ <ENTRY>lseg '((0,0),(0,1))' ?-| lseg '((0,0),(1,0))'</ENTRY>
2122
2122
</ROW>
2123
2123
<ROW>
2124
2124
<ENTRY> @-@ </ENTRY>
2125
2125
<ENTRY>Length or circumference</ENTRY>
2126
- <ENTRY>@-@ '((0,0),(1,0))'::path </ENTRY>
2126
+ <ENTRY>@-@ path '((0,0),(1,0))'</ENTRY>
2127
2127
</ROW>
2128
2128
<ROW>
2129
2129
<ENTRY> ?| </ENTRY>
2130
2130
<ENTRY>Is vertical?</ENTRY>
2131
- <ENTRY>'(0,1)'::point ?| '(0,0)'::point </ENTRY>
2131
+ <ENTRY>point '(0,1)' ?| point '(0,0)'</ENTRY>
2132
2132
</ROW>
2133
2133
<ROW>
2134
2134
<ENTRY> ?|| </ENTRY>
2135
2135
<ENTRY>Is parallel?</ENTRY>
2136
- <ENTRY>'((-1,0),(1,0))'::lseg ?|| '((-1,2),(1,2))'::lseg </ENTRY>
2136
+ <ENTRY>lseg '((-1,0),(1,0))' ?|| lseg '((-1,2),(1,2))'</ENTRY>
2137
2137
</ROW>
2138
2138
<ROW>
2139
2139
<ENTRY> @ </ENTRY>
2140
2140
<ENTRY>Contained or on</ENTRY>
2141
- <ENTRY>'(1,1)'::point @ '((0,0),2)'::circle </ENTRY>
2141
+ <ENTRY>point '(1,1)' @ circle '((0,0),2)'</ENTRY>
2142
2142
</ROW>
2143
2143
<ROW>
2144
2144
<ENTRY> @@ </ENTRY>
2145
2145
<ENTRY>Center of</ENTRY>
2146
- <ENTRY>@@ '((0,0),10)'::circle </ENTRY>
2146
+ <ENTRY>@@ circle '((0,0),10)'</ENTRY>
2147
2147
</ROW>
2148
2148
<ROW>
2149
2149
<ENTRY> ~= </ENTRY>
2150
2150
<ENTRY>Same as</ENTRY>
2151
- <ENTRY>'((0,0),(1,1))'::polygon ~= '((1,1),(0,0))'::polygon </ENTRY>
2151
+ <ENTRY>polygon '((0,0),(1,1))' ~= polygon '((1,1),(0,0))'</ENTRY>
2152
2152
</ROW>
2153
2153
</TBODY>
2154
2154
</TGROUP>
2168
2168
<tbody>
2169
2169
<row>
2170
2170
<entry>area(object)</entry>
2171
- <entry>float8 </entry>
2171
+ <entry>double precision </entry>
2172
2172
<entry>area of item</entry>
2173
2173
<entry>area(box '((0,0),(1,1))')</entry>
2174
2174
</row>
2175
2175
<row>
2176
- <entry>box(box,box)</entry>
2176
+ <entry>box(box, box)</entry>
2177
2177
<entry>box</entry>
2178
2178
<entry>intersection box</entry>
2179
2179
<entry>box(box '((0,0),(1,1))',box '((0.5,0.5),(2,2))')</entry>
2186
2186
</row>
2187
2187
<row>
2188
2188
<entry>diameter(circle)</entry>
2189
- <entry>float8 </entry>
2189
+ <entry>double precision </entry>
2190
2190
<entry>diameter of circle</entry>
2191
2191
<entry>diameter(circle '((0,0),2.0)')</entry>
2192
2192
</row>
2193
2193
<row>
2194
2194
<entry>height(box)</entry>
2195
- <entry>float8 </entry>
2195
+ <entry>double precision </entry>
2196
2196
<entry>vertical size of box</entry>
2197
2197
<entry>height(box '((0,0),(1,1))')</entry>
2198
2198
</row>
2210
2210
</row>
2211
2211
<row>
2212
2212
<entry>length(object)</entry>
2213
- <entry>float8 </entry>
2213
+ <entry>double precision </entry>
2214
2214
<entry>length of item</entry>
2215
2215
<entry>length(path '((-1,0),(1,0))')</entry>
2216
2216
</row>
@@ -2243,13 +2243,13 @@ Not defined by this name. Implements the intersection operator '#'
2243
2243
</row>
2244
2244
<row>
2245
2245
<entry>radius(circle)</entry>
2246
- <entry>float8 </entry>
2246
+ <entry>double precision </entry>
2247
2247
<entry>radius of circle</entry>
2248
2248
<entry>radius(circle '((0,0),2.0)')</entry>
2249
2249
</row>
2250
2250
<row>
2251
2251
<entry>width(box)</entry>
2252
- <entry>float8 </entry>
2252
+ <entry>double precision </entry>
2253
2253
<entry>horizontal size</entry>
2254
2254
<entry>width(box '((0,0),(1,1))')</entry>
2255
2255
</row>
@@ -2274,91 +2274,91 @@ Not defined by this name. Implements the intersection operator '#'
2274
2274
<entry>box(circle)</entry>
2275
2275
<entry>box</entry>
2276
2276
<entry>circle to box</entry>
2277
- <entry>box('((0,0),2.0)'::circle )</entry>
2277
+ <entry>box(circle '((0,0),2.0)')</entry>
2278
2278
</row>
2279
2279
<row>
2280
- <entry>box(point,point)</entry>
2280
+ <entry>box(point, point)</entry>
2281
2281
<entry>box</entry>
2282
2282
<entry>points to box</entry>
2283
- <entry>box('(0,0)'::point, '(1,1)'::point )</entry>
2283
+ <entry>box(point '(0,0)', point '(1,1)')</entry>
2284
2284
</row>
2285
2285
<row>
2286
2286
<entry>box(polygon)</entry>
2287
2287
<entry>box</entry>
2288
2288
<entry>polygon to box</entry>
2289
- <entry>box('((0,0),(1,1),(2,0))'::polygon )</entry>
2289
+ <entry>box(polygon '((0,0),(1,1),(2,0))')</entry>
2290
2290
</row>
2291
2291
<row>
2292
2292
<entry>circle(box)</entry>
2293
2293
<entry>circle</entry>
2294
2294
<entry>to circle</entry>
2295
- <entry>circle('((0,0),(1,1))'::box )</entry>
2295
+ <entry>circle(box '((0,0),(1,1))')</entry>
2296
2296
</row>
2297
2297
<row>
2298
- <entry>circle(point,float8 )</entry>
2298
+ <entry>circle(point, double precision )</entry>
2299
2299
<entry>circle</entry>
2300
2300
<entry>point to circle</entry>
2301
- <entry>circle('(0,0)'::point, 2.0)</entry>
2301
+ <entry>circle(point '(0,0)', 2.0)</entry>
2302
2302
</row>
2303
2303
<row>
2304
2304
<entry>lseg(box)</entry>
2305
2305
<entry>lseg</entry>
2306
2306
<entry>box diagonal to lseg</entry>
2307
- <entry>lseg('((-1,0),(1,0))'::box )</entry>
2307
+ <entry>lseg(box '((-1,0),(1,0))')</entry>
2308
2308
</row>
2309
2309
<row>
2310
- <entry>lseg(point,point)</entry>
2310
+ <entry>lseg(point, point)</entry>
2311
2311
<entry>lseg</entry>
2312
2312
<entry>points to lseg</entry>
2313
- <entry>lseg('(-1,0)'::point, '(1,0)'::point )</entry>
2313
+ <entry>lseg(point '(-1,0)', point '(1,0)')</entry>
2314
2314
</row>
2315
2315
<row>
2316
2316
<entry>path(polygon)</entry>
2317
2317
<entry>point</entry>
2318
2318
<entry>polygon to path</entry>
2319
- <entry>path('((0,0),(1,1),(2,0))'::polygon )</entry>
2319
+ <entry>path(polygon '((0,0),(1,1),(2,0))')</entry>
2320
2320
</row>
2321
2321
<row>
2322
2322
<entry>point(circle)</entry>
2323
2323
<entry>point</entry>
2324
2324
<entry>center</entry>
2325
- <entry>point('((0,0),2.0)'::circle )</entry>
2325
+ <entry>point(circle '((0,0),2.0)')</entry>
2326
2326
</row>
2327
2327
<row>
2328
- <entry>point(lseg,lseg)</entry>
2328
+ <entry>point(lseg, lseg)</entry>
2329
2329
<entry>point</entry>
2330
2330
<entry>intersection</entry>
2331
- <entry>point('((-1,0),(1,0))'::lseg, '((-2,-2),(2,2))'::lseg )</entry>
2331
+ <entry>point(lseg '((-1,0),(1,0))', lseg '((-2,-2),(2,2))')</entry>
2332
2332
</row>
2333
2333
<row>
2334
2334
<entry>point(polygon)</entry>
2335
2335
<entry>point</entry>
2336
2336
<entry>center</entry>
2337
- <entry>point('((0,0),(1,1),(2,0))'::polygon )</entry>
2337
+ <entry>point(polygon '((0,0),(1,1),(2,0))')</entry>
2338
2338
</row>
2339
2339
<row>
2340
2340
<entry>polygon(box)</entry>
2341
2341
<entry>polygon</entry>
2342
2342
<entry>12 point polygon</entry>
2343
- <entry>polygon('((0,0),(1,1))'::box )</entry>
2343
+ <entry>polygon(box '((0,0),(1,1))')</entry>
2344
2344
</row>
2345
2345
<row>
2346
2346
<entry>polygon(circle)</entry>
2347
2347
<entry>polygon</entry>
2348
2348
<entry>12-point polygon</entry>
2349
- <entry>polygon('((0,0),2.0)'::circle )</entry>
2349
+ <entry>polygon(circle '((0,0),2.0)')</entry>
2350
2350
</row>
2351
2351
<row>
2352
- <entry>polygon(<replaceable class="parameter">npts</replaceable>,circle)</entry>
2352
+ <entry>polygon(<replaceable class="parameter">npts</replaceable>, circle)</entry>
2353
2353
<entry>polygon</entry>
2354
2354
<entry><replaceable class="parameter">npts</replaceable> polygon</entry>
2355
- <entry>polygon(12,'((0,0),2.0)'::circle )</entry>
2355
+ <entry>polygon(12, circle '((0,0),2.0)')</entry>
2356
2356
</row>
2357
2357
<row>
2358
2358
<entry>polygon(path)</entry>
2359
2359
<entry>polygon</entry>
2360
2360
<entry>path to polygon</entry>
2361
- <entry>polygon('((0,0),(1,1),(2,0))'::path )</entry>
2361
+ <entry>polygon(path '((0,0),(1,1),(2,0))')</entry>
2362
2362
</row>
2363
2363
</tbody>
2364
2364
</tgroup>
0 commit comments