<HTML ><HEAD ><TITLE >dbminsert</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK REL="HOME" TITLE="PHP Manual" HREF="manual.html"><LINK REL="UP" TITLE="dbm functions" HREF="ref.dbm.html"><LINK REL="PREVIOUS" TITLE="dbmfetch" HREF="function.dbmfetch.html"><LINK REL="NEXT" TITLE="dbmreplace" HREF="function.dbmreplace.html"></HEAD ><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.dbmfetch.html" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.dbmreplace.html" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.dbminsert" >dbminsert</A ></H1 ><DIV CLASS="refnamediv" ><A NAME="AEN7608" ></A >dbminsert -- inserts a value for a key in a dbm database</DIV ><DIV CLASS="refsect1" ><A NAME="AEN7611" ></A ><H2 >Description</H2 ><DIV CLASS="funcsynopsis" ><P ></P ><CODE CLASS="FUNCDEF" >int dbminsert</CODE >(int dbm_identifier, string key, string value);<P ></P ></DIV ><P > Adds the value to the database with the specified key.</P ><P > Returns -1 if the database was opened read-only, 0 if the insert was successful, and 1 if the specified key already exists. (To replace the value, use <A HREF="function.dbmreplace.html" ><B CLASS="function" >dbmreplace()</B ></A >.)</P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.dbmfetch.html" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="manual.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.dbmreplace.html" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >dbmfetch</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.dbm.html" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >dbmreplace</TD ></TR ></TABLE ></DIV ></BODY ></HTML >