Files
php-doc-ru/reference/dbase/functions/dbase-add-record.xml
2024-09-26 10:33:38 +03:00

145 lines
4.0 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0545e305cf06937b14b3f0694d6e716c9881ffd7 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.dbase-add-record" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dbase_add_record</refname>
<refpurpose>Добавляет запись в базу данных</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dbase_add_record</methodname>
<methodparam><type>resource</type><parameter>database</parameter></methodparam>
<methodparam><type>array</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Функция добавляет данные в базу данных.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
Ресурс базы данных, который возвращает функция <function>dbase_open</function>
или <function>dbase_create</function>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
Индексный массив с данными. В аргументе передают массив, в котором количество элементов
равно количеству полей в базе данных, иначе функция <function>dbase_add_record</function>
завершится ошибкой.
</para>
<note>
<para>
При передаче в параметр записи, которую вернула функция <function>dbase_get_record</function>,
вначале сбрасывают в записи ключ с именем <literal>deleted</literal> (прим пер. — unset(record['deleted']).
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL-модуль dbase 7.0.0</entry>
<entry>
Параметр <parameter>database</parameter> теперь принимает аргумент
с типом <type>resource</type>, а не <type>int</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример вставки записи в базу данных dBase</title>
<programlisting role="php">
<![CDATA[
<?php
// Открываем БД в режиме чтения и записи
$db = dbase_open('/tmp/test.dbf', 2);
if ($db) {
dbase_add_record(
$db,
array(
date('Ymd'),
'Maxim Topolov',
'23',
'max@example.com',
'T',
)
);
dbase_close($db);
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>dbase_delete_record</function></member>
<member><function>dbase_replace_record</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->