2 * Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
4 * This component and the accompanying materials are made available
5 * under the terms of "Eclipse Public License v1.0"
6 * which accompanies this distribution, and is available
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
9 * Initial Contributors:
10 * Nokia Corporation - initial contribution.
15 * Name : siprequireheader.h
17 * Interface : SDK API, SIP Codec API
25 #ifndef CSIPREQUIREHEADER_H
26 #define CSIPREQUIREHEADER_H
29 #include "siptokenheaderbase.h"
36 * Class provides functions for setting and getting parameters in
37 * SIP "Require" header.
41 class CSIPRequireHeader : public CSIPTokenHeaderBase
43 public: // Constructors and destructor
46 * Constructs a CSIPRequireHeader from textual representation
47 * of the header's value part.
48 * @param aValue a value part of a "Require"-header
49 * @return an array containing 1..n instances of CSIPRequireHeader
51 IMPORT_C static RPointerArray<CSIPRequireHeader>
52 DecodeL(const TDesC8& aValue);
55 * Creates a new instance of CSIPRequireHeader
56 * @param aValue a tag value
57 * @return a new instance of CSIPRequireHeader
59 IMPORT_C static CSIPRequireHeader* NewL(RStringF aValue);
62 * Creates a new instance of CSIPRequireHeader
63 * and puts it to CleanupStack
64 * @param aValue a tag value
65 * @return a new instance of CSIPRequireHeader
67 IMPORT_C static CSIPRequireHeader* NewLC(RStringF aValue);
70 * Destructor, deletes the resources of CSIPRequireHeader.
72 IMPORT_C ~CSIPRequireHeader();
75 public: // New functions
78 * Constructs an instance of a CSIPRequireHeader from a RReadStream
79 * @param aReadStream a stream containing the value of the
80 * externalized object (header name not included).
81 * @return an instance of a CSIPRequireHeader
83 IMPORT_C static CSIPHeaderBase* InternalizeValueL(RReadStream& aReadStream);
86 public: // From CSIPHeaderBase
89 * From CSIPHeaderBase CloneL
91 IMPORT_C CSIPHeaderBase* CloneL() const;
94 * From CSIPHeaderBase Name
96 IMPORT_C RStringF Name() const;
99 public: // From CSIPHeaderBase, For internal use
104 TPreferredPlace PreferredPlaceInMessage() const;
106 public: // New functions, for internal use
108 static RPointerArray<CSIPHeaderBase> BaseDecodeL(const TDesC8& aValue);
110 private: // Constructors
113 CSIPRequireHeader(const CSIPRequireHeader& aHeader);
116 #endif // end of CSIPREQUIREHEADER_H