| Index: gcc/libstdc++-v3/doc/xml/manual/utilities.xml
|
| diff --git a/gcc/libstdc++-v3/doc/xml/manual/utilities.xml b/gcc/libstdc++-v3/doc/xml/manual/utilities.xml
|
| deleted file mode 100644
|
| index 56d614ec6822fabe44576e25bbf7a767cd7dd356..0000000000000000000000000000000000000000
|
| --- a/gcc/libstdc++-v3/doc/xml/manual/utilities.xml
|
| +++ /dev/null
|
| @@ -1,131 +0,0 @@
|
| -<?xml version='1.0'?>
|
| -<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
| - "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
|
| -[ ]>
|
| -
|
| -<part id="manual.util" xreflabel="Utilities">
|
| -<?dbhtml filename="utilities.html"?>
|
| -
|
| -<partinfo>
|
| - <keywordset>
|
| - <keyword>
|
| - ISO C++
|
| - </keyword>
|
| - <keyword>
|
| - library
|
| - </keyword>
|
| - </keywordset>
|
| -</partinfo>
|
| -
|
| -<title>
|
| - Utilities
|
| - <indexterm><primary>Utilities</primary></indexterm>
|
| -</title>
|
| -
|
| -<!-- Chapter 01 : Functors -->
|
| -<chapter id="manual.util.functors" xreflabel="Functors">
|
| -<?dbhtml filename="functors.html"?>
|
| - <title>Functors</title>
|
| - <para>If you don't know what functors are, you're not alone. Many people
|
| - get slightly the wrong idea. In the interest of not reinventing
|
| - the wheel, we will refer you to the introduction to the functor
|
| - concept written by SGI as part of their STL, in
|
| - <ulink url="http://www.sgi.com/tech/stl/functors.html">their
|
| - http://www.sgi.com/tech/stl/functors.html</ulink>.
|
| - </para>
|
| -</chapter>
|
| -
|
| -<!-- Chapter 02 : Pairs -->
|
| -<chapter id="manual.util.pairs" xreflabel="Pairs">
|
| -<?dbhtml filename="pairs.html"?>
|
| - <title>Pairs</title>
|
| - <para>The <code>pair<T1,T2></code> is a simple and handy way to
|
| - carry around a pair of objects. One is of type T1, and another of
|
| - type T2; they may be the same type, but you don't get anything
|
| - extra if they are. The two members can be accessed directly, as
|
| - <code>.first</code> and <code>.second</code>.
|
| - </para>
|
| - <para>Construction is simple. The default ctor initializes each member
|
| - with its respective default ctor. The other simple ctor,
|
| - </para>
|
| - <programlisting>
|
| - pair (const T1& x, const T2& y);
|
| - </programlisting>
|
| - <para>does what you think it does, <code>first</code> getting <code>x</code>
|
| - and <code>second</code> getting <code>y</code>.
|
| - </para>
|
| - <para>There is a copy constructor, but it requires that your compiler
|
| - handle member function templates:
|
| - </para>
|
| - <programlisting>
|
| - template <class U, class V> pair (const pair<U,V>& p);
|
| - </programlisting>
|
| - <para>The compiler will convert as necessary from U to T1 and from
|
| - V to T2 in order to perform the respective initializations.
|
| - </para>
|
| - <para>The comparison operators are done for you. Equality
|
| - of two <code>pair<T1,T2></code>s is defined as both <code>first</code>
|
| - members comparing equal and both <code>second</code> members comparing
|
| - equal; this simply delegates responsibility to the respective
|
| - <code>operator==</code> functions (for types like MyClass) or builtin
|
| - comparisons (for types like int, char, etc).
|
| - </para>
|
| - <para>
|
| - The less-than operator is a bit odd the first time you see it. It
|
| - is defined as evaluating to:
|
| - </para>
|
| - <programlisting>
|
| - x.first < y.first ||
|
| - ( !(y.first < x.first) && x.second < y.second )
|
| - </programlisting>
|
| - <para>The other operators are not defined using the <code>rel_ops</code>
|
| - functions above, but their semantics are the same.
|
| - </para>
|
| - <para>Finally, there is a template function called <function>make_pair</function>
|
| - that takes two references-to-const objects and returns an
|
| - instance of a pair instantiated on their respective types:
|
| - </para>
|
| - <programlisting>
|
| - pair<int,MyClass> p = make_pair(4,myobject);
|
| - </programlisting>
|
| -
|
| -</chapter>
|
| -
|
| -<!-- Chapter 03 : Memory -->
|
| -<chapter id="manual.util.memory" xreflabel="Memory">
|
| -<?dbhtml filename="memory.html"?>
|
| - <title>Memory</title>
|
| - <para>
|
| - Memory contains three general areas. First, function and operator
|
| - calls via <function>new</function> and <function>delete</function>
|
| - operator or member function calls. Second, allocation via
|
| - <classname>allocator</classname>. And finally, smart pointer and
|
| - intelligent pointer abstractions.
|
| - </para>
|
| -
|
| - <!-- Section 01 : allocator -->
|
| - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
| - parse="xml" href="allocator.xml">
|
| - </xi:include>
|
| -
|
| - <!-- Section 02 : auto_ptr -->
|
| - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
| - parse="xml" href="auto_ptr.xml">
|
| - </xi:include>
|
| -
|
| - <!-- Section 03 : shared_ptr -->
|
| - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
| - parse="xml" href="shared_ptr.xml">
|
| - </xi:include>
|
| -
|
| -</chapter>
|
| -
|
| -<!-- Chapter 04 : Traits -->
|
| -<chapter id="manual.util.traits" xreflabel="Traits">
|
| -<?dbhtml filename="traits.html"?>
|
| - <title>Traits</title>
|
| - <para>
|
| - </para>
|
| -</chapter>
|
| -
|
| -</part>
|
|
|