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

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

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

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

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

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

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

<concept id="GUID-2364CAB0-E19E-5EBB-837F-F6484642C2E4" xml:lang="en"><title>Headers</title><shortdesc>A header forms the anchor point for a singly linked list.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

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

the elements of the list, the header includes <i>link</i> objects as components.</p>

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

<ul>

<li id="GUID-813BAAF4-F526-5E08-8165-5361D641A097"><p>allows elements to be

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

middle.</p> </li>

<li id="GUID-5001CEBA-CCBE-5F6C-B0CD-A15DF0BDB8B9"><p>tests if an element

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

<li id="GUID-7E459E1C-2BA8-54D6-9C1C-02AA13C8A77A"><p>returns pointers to

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

<li id="GUID-01A424E1-AFA9-55D1-B61E-DA1DE372F9D0"><p>removes elements from

the list.</p> </li>

</ul>

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

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