1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-591552AB-D708-5CB5-9597-A0AF3D303178" xml:lang="en"><title>Headers</title><shortdesc>This document describes the concept of headers as regards to doubly

    13 linked lists.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>A header forms the anchor point for a doubly linked list. In common with

    15 the elements of the list, the header includes a <i>link</i> object as a component.</p>

    16 <p>The header includes the following functionality:</p>

    17 <ul>

    18 <li id="GUID-A713D790-2003-5788-889F-E3B3D9669B0D"><p>allows elements to be

    19 added to the start and end of a doubly linked list, but <i>not</i> to the

    20 middle.</p> </li>

    21 <li id="GUID-84EB986A-7501-57FF-BFD0-DB67182A3050"><p>tests if an element

    22 is at the start or end of a list.</p> </li>

    23 <li id="GUID-94683FD4-C576-520D-8CEC-D1D7A8978D0C"><p>returns pointers to

    24 elements at the start or the end of a list.</p> </li>

    25 </ul>

    26 <p>A header is an instance of the templated class <codeph>TDblQue&lt;class

    27         T&gt;</codeph>.</p>

    28 </conbody></concept>