<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/mssql.xml, last change in rev 1.2 -->
  <refentry id="function.mssql-select-db">
   <refnamediv>
    <refname>mssql_select_db</refname>
    <refpurpose>Select MS SQL database</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>mssql_select_db</methodname>
      <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>link_identifier</parameter></methodparam>
     </methodsynopsis>
    <para> Returns: &true; on success, &false; on error
    </para>
    <para> 
     <function>mssql_select_db</function> sets the current active
     database on the server that's associated with the specified link
     identifier.  If no link identifier is specified, the last opened
     link is assumed.  If no link is open, the function will try to
     establish a link as if <function>mssql_connect</function> was
     called, and use it.
    </para>
    <para>
     Every subsequent call to <function>mssql_query</function> will be
     made on the active database.
    </para>
    <para>
     In order to select a database containing a space or a hypen ("-") you
     need to enclose the database name in brackets, like is shown in the
     example below:
    </para>
    <example>
     <title><function>mssql_select_db</function> example</title>
     <programlisting role="php">
<![CDATA[
<?php
    $conn = mssql_connect('MYSQLSERVER', 'sa', 'password');
    mssql_select_db('[my data-base]', $conn);
?>
]]>
     </programlisting>
    </example>
    <para> See also:
     <function>mssql_connect</function>, 
     <function>mssql_pconnect</function>, and
     <function>mssql_query</function>
    </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:"../../../../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
-->