summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref/drop_cast.sgml
blob: 37152114bcaeae44c2fefdd14d8b2b5f0aec6e40 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_cast.sgml,v 1.1 2002/07/18 23:11:27 petere Exp $ -->

<refentry id="SQL-DROPCAST">
 <refmeta>
  <refentrytitle id="SQL-DROPCAST-TITLE">DROP CAST</refentrytitle>
  <refmiscinfo>SQL - Language Statements</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>DROP CAST</refname>
  <refpurpose>remove a user-defined cast</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
<synopsis>
DROP CAST (<replaceable>sourcetype</replaceable> AS <replaceable>targettype</replaceable>)
    [ CASCADE | RESTRICT ]
</synopsis>
 </refsynopsisdiv>
  
 <refsect1 id="sql-dropcast-description">
  <title>Description</title>

  <para>
   <command>DROP CAST</command> removes a previously defined cast.
  </para>

  <para>
   To be able to drop a cast, you must own the underlying function.
   To be able to drop a binary compatible cast, you must own both the
   source and the target data type.  These are the same privileges
   that are required to create a cast.
  </para>

   <variablelist>
    <title>Parameters</title>

    <varlistentry>
     <term><replaceable>sourcetype</replaceable></term>

     <listitem>
      <para>
       The name of the source data type of the cast.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><replaceable>targettype</replaceable></term>

     <listitem>
      <para>
       The name of the target data type of the cast.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><literal>CASCADE</literal></term>
     <term><literal>RESTRICT</literal></term>

     <listitem>
      <para>
       These key words do not have any effect, since there are no
       dependencies on casts.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>

 </refsect1>

 <refsect1 id="sql-dropcast-notes">
  <title>Notes</title>

  <para>
   Use <command>CREATE CAST</command> to create user-defined casts.
  </para>

  <para>
   The privileges required to drop a cast may be changed in a future
   release.
  </para>
 </refsect1>


 <refsect1 id="sql-dropcast-examples">
  <title>Examples</title>

  <para>
   To drop the cast from type <type>text</type> to type <type>int</type>:
<programlisting>
DROP CAST (text AS int4);
</programlisting>
  </para>
 </refsect1>

 
 <refsect1 id="sql-dropcast-compat">
  <title>Compatibility</title>

  <para>
   The <command>DROP CAST</command> command conforms to SQL99.
  </para>
 </refsect1>


 <refsect1 id="sql-dropcast-seealso">
  <title>See Also</title>

  <para>
   <xref linkend="sql-createcast" endterm="sql-createcast-title">
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode:sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
-->