mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add SGML ID attributes to the arrays subsections, and a few index entries for

Browse Source 
them.
This commit is contained in:
Alvaro Herrera 2008-04-27 04:33:27 +00:00
parent ea0382e370
commit a1d479f518
1 changed files with 32 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/src/sgml/array.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/array.sgml,v 1.64 2008/03/26 16:34:47 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/array.sgml,v 1.65 2008/04/27 04:33:27 alvherre Exp $ -->
<sect1 id="arrays">
<title>Arrays</title>
@ -15,9 +15,14 @@
Arrays of domains are not yet supported.
</para>
<sect2>
<sect2 id="arrays-declaration">
<title>Declaration of Array Types</title>
<indexterm>
<primary>array</primary>
<secondary>declaration</secondary>
</indexterm>
<para>
To illustrate the use of array types, we create this table:
<programlisting>
@ -77,7 +82,7 @@ CREATE TABLE tictactoe (
</para>
</sect2>
<sect2>
<sect2 id="arrays-input">
<title>Array Value Input</title>
<indexterm>
@ -189,9 +194,14 @@ ERROR: multidimensional arrays must have array expressions with matching dimens
</para>
</sect2>
<sect2>
<sect2 id="arrays-accessing">
<title>Accessing Arrays</title>
<indexterm>
<primary>array</primary>
<secondary>accessing</secondary>
</indexterm>
<para>
Now, we can run some queries on the table.
First, we show how to access a single element of an array at a time.
@ -315,9 +325,14 @@ SELECT array_upper(schedule, 1) FROM sal_emp WHERE name = 'Carol';
</para>
</sect2>
<sect2>
<sect2 id="arrays-modifying">
<title>Modifying Arrays</title>
<indexterm>
<primary>array</primary>
<secondary>modifying</secondary>
</indexterm>
<para>
An array value can be replaced completely:
@ -489,9 +504,14 @@ SELECT array_cat(ARRAY[5,6], ARRAY[[1,2],[3,4]]);
</para>
</sect2>
<sect2>
<sect2 id="arrays-searching">
<title>Searching in Arrays</title>
<indexterm>
<primary>array</primary>
<secondary>searching</secondary>
</indexterm>
<para>
To search for a value in an array, you must check each value of the
array. This can be done by hand, if you know the size of the array.
@ -533,9 +553,14 @@ SELECT * FROM sal_emp WHERE 10000 = ALL (pay_by_quarter);
</tip>
</sect2>
<sect2>
<sect2 id="arrays-io">
<title>Array Input and Output Syntax</title>
<indexterm>
<primary>array</primary>
<secondary>I/O</secondary>
</indexterm>
<para>
The external text representation of an array value consists of items that
are interpreted according to the I/O conversion rules for the array's