reference/dbase/functions/dbase-get-record.xml
e41806c30bf6975e452c0d4ce35ab0984c2fa68c
...
...
@@ -11,8 +11,8 @@
11
11
&reftitle.description;
12
12
<methodsynopsis>
13
13
<type>array</type><methodname>dbase_get_record</methodname>
14
-
<methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam>
15
-
<methodparam><type>int</type><parameter>record_number</parameter></methodparam>
14
+
<methodparam><type>resource</type><parameter>database</parameter></methodparam>
15
+
<methodparam><type>int</type><parameter>number</parameter></methodparam>
16
16
</methodsynopsis>
17
17
<para>
18
18
Gets a record from a database as an indexed array.
...
...
@@ -23,19 +23,20 @@
23
23
<para>
24
24
<variablelist>
25
25
<varlistentry>
26
-
<term><parameter>dbase_identifier</parameter></term>
26
+
<term><parameter>database</parameter></term>
27
27
<listitem>
28
28
<para>
29
-
The database link identifier, returned by <function>dbase_open</function>
29
+
The database resource, returned by <function>dbase_open</function>
30
30
or <function>dbase_create</function>.
31
31
</para>
32
32
</listitem>
33
33
</varlistentry>
34
34
<varlistentry>
35
-
<term><parameter>record_number</parameter></term>
35
+
<term><parameter>number</parameter></term>
36
36
<listitem>
37
37
<para>
38
-
The index of the record.
38
+
The index of the record between <literal>1</literal> and
39
+
<literal>dbase_numrecords($dbase_identifier)</literal>.
39
40
</para>
40
41
</listitem>
41
42
</varlistentry>
...
...
@@ -49,26 +50,35 @@
49
50
key named <literal>deleted</literal> which is set to 1 if the record has been
50
51
marked for deletion (see <function>dbase_delete_record</function>).
51
52
</para>
52
-
<para>
53
-
Each field is converted to the appropriate PHP type, except:
54
-
<itemizedlist>
55
-
<listitem>
56
-
<simpara>
57
-
Dates are left as strings.
58
-
</simpara>
59
-
</listitem>
60
-
<listitem>
61
-
<simpara>
62
-
Integers that would have caused an overflow (&gt; 32 bits)
63
-
are returned as strings.
64
-
</simpara>
65
-
</listitem>
66
-
</itemizedlist>
67
-
</para>
53
+
&dbase.type-conversion;
68
54
<para>
69
55
On error, <function>dbase_get_record</function> will return &false;.
70
56
</para>
71
57
</refsect1>
58
+

59
+
<refsect1 role="changelog">
60
+
&reftitle.changelog;
61
+
<informaltable>
62
+
<tgroup cols="2">
63
+
<thead>
64
+
<row>
65
+
<entry>&Version;</entry>
66
+
<entry>&Description;</entry>
67
+
</row>
68
+
</thead>
69
+
<tbody>
70
+
<row>
71
+
<entry>dbase 7.0.0</entry>
72
+
<entry>
73
+
<parameter>database</parameter> is now a <type>resource</type>
74
+
instead of an <type>int</type>.
75
+
</entry>
76
+
</row>
77
+
</tbody>
78
+
</tgroup>
79
+
</informaltable>
80
+
</refsect1>
81
+

72
82
<refsect1 role="seealso">
73
83
&reftitle.seealso;
74
84
<para>
75
85