1 /*

     2 * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     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".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Helper class for parsing SDP attribute query results.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef BTENGSDPATTRPARSER_H

    21 #define BTENGSDPATTRPARSER_H

    22 

    23 

    24 #include <btsdp.h>

    25 

    26 #include "btengdiscovery.h"

    27 

    28 

    29 /**

    30  *  Class CBTEngSdpAttrParser

    31  *

    32  *  ?more_complete_description

    33  *

    34  *  @lib ?library

    35  *  @since S60 v3.2

    36  */

    37 NONSHARABLE_CLASS( CBTEngSdpAttrParser ) : public CBase, 

    38                                            public MSdpAttributeValueVisitor

    39     {

    40 

    41 public:

    42 

    43     /**

    44      * Two-phase constructor

    45      */

    46     static CBTEngSdpAttrParser* NewL( RSdpResultArray* aResultArray );

    47 

    48     /**

    49      * Destructor

    50      */

    51     virtual ~CBTEngSdpAttrParser();

    52 

    53     /**

    54      * ?description

    55      *

    56      * @since S60 v3.2

    57      * @param ?arg1 ?description

    58      * @param ?arg2 ?description

    59      * @return ?description

    60      */

    61     void SetAttributeID( TSdpAttributeID aAttrId );

    62 

    63 // from base class MSdpAttributeValueVisitor

    64 

    65     /**

    66      * From MSdpAttributeValueVisitor.

    67      * Called to pass an attribute value.

    68      *

    69      * @since S60 v3.2

    70      * @param ?arg1 ?description

    71      */

    72     virtual void VisitAttributeValueL( CSdpAttrValue &aValue, TSdpElementType aType );

    73 

    74     /**

    75      * From MSdpAttributeValueVisitor.

    76      * Called to indicate the start of a list of attribute values. 

    77      * This call is followed by a call to VisitAttributeValueL() 

    78      * for each attribute value in the list, and concluded by 

    79      * a call to EndList().

    80      *

    81      * @since S60 v3.2

    82      * @param ?arg1 ?description

    83      */

    84     virtual void StartListL( CSdpAttrValueList &aList );

    85 

    86     /**

    87      * From MSdpAttributeValueVisitor.

    88      * Called to indicate the end of a list of attribute values.

    89      *

    90      * @since S60 v3.2

    91      * @param ?arg1 ?description

    92      */

    93     virtual void EndListL();

    94 

    95 private:

    96 

    97     /**

    98      * C++ default constructor

    99      */

   100     CBTEngSdpAttrParser( RSdpResultArray* aResultArray );

   101 

   102     /**

   103      * Symbian 2nd-phase constructor

   104      */

   105     void ConstructL();

   106 

   107 private: // data

   108 

   109     /**

   110      * ?description_of_member

   111      */

   112     TInt iNestingLevel;

   113 

   114     /**

   115      * ?description_of_member

   116      */

   117     TSdpAttributeID iAttrId;

   118 

   119     /**

   120      * Reference to the array for storing the parsed result.

   121      * Not own.

   122      */

   123     RSdpResultArray* iResultArray;

   124 

   125     };

   126 

   127 

   128 #endif // BTENGSDPATTRPARSER_H