mtpdataproviders/mtpimagedp/src/cmtpimagedpgetobjectpropdesc.cpp
changeset 0 d0791faffa3f
child 2 4843bb5893b6
equal deleted inserted replaced
-1:000000000000 0:d0791faffa3f
       
     1 // Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     2 // All rights reserved.
       
     3 // This component and the accompanying materials are made available
       
     4 // under the terms of "Eclipse Public License v1.0"
       
     5 // which accompanies this distribution, and is available
       
     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     7 //
       
     8 // Initial Contributors:
       
     9 // Nokia Corporation - initial contribution.
       
    10 //
       
    11 // Contributors:
       
    12 //
       
    13 // Description:
       
    14 //
       
    15 
       
    16 /**
       
    17  @file
       
    18  @internalTechnology
       
    19 */
       
    20 
       
    21 #include <f32file.h>
       
    22 #include <mtp/tmtptyperequest.h>
       
    23 #include <mtp/mmtpdataproviderframework.h>
       
    24 #include <mtp/mtpprotocolconstants.h>
       
    25 #include <mtp/mmtpobjectmgr.h>
       
    26 #include <mtp/cmtptypeobjectpropdesc.h>
       
    27 #include <mtp/cmtptypestring.h>
       
    28 
       
    29 #include "mtpdpconst.h"
       
    30 #include "cmtpimagedpgetobjectpropdesc.h"
       
    31 #include "mtpimagedpconst.h"
       
    32 #include "mtpimagedppanic.h"
       
    33 #include "cmtpimagedp.h"
       
    34 
       
    35 __FLOG_STMT(_LIT8(KComponent,"GetObjectPropDesc");)
       
    36 
       
    37 _LIT(KMtpObjDescObjFileName, "[a-zA-Z!#\\$%&'\\(\\)\\-0-9@\\^_\\`\\{\\}\\~][a-zA-Z!#\\$%&'\\(\\)\\-0-9@\\^_\\`\\{\\}\\~ ]{0, 7}\\.[[a-zA-Z!#\\$%&'\\(\\)\\-0-9@\\^_\\`\\{\\}\\~][a-zA-Z!#\\$%&'\\(\\)\\-0-9@\\^_\\`\\{\\}\\~ ]{0, 2}]?");
       
    38 
       
    39 /**
       
    40 Two-phase construction method
       
    41 @param aPlugin	The data provider plugin
       
    42 @param aFramework	The data provider framework
       
    43 @param aConnection	The connection from which the request comes
       
    44 @return a pointer to the created request processor object
       
    45 */ 
       
    46 MMTPRequestProcessor* CMTPImageDpGetObjectPropDesc::NewL(
       
    47                                             MMTPDataProviderFramework& aFramework,
       
    48                                             MMTPConnection& aConnection,CMTPImageDataProvider& /*aDataProvider*/)
       
    49     {
       
    50     CMTPImageDpGetObjectPropDesc* self = new (ELeave) CMTPImageDpGetObjectPropDesc(aFramework, aConnection);
       
    51     CleanupStack::PushL(self);
       
    52     self->ConstructL();
       
    53     CleanupStack::Pop(self);
       
    54     return self;
       
    55 
       
    56     }
       
    57 
       
    58 /**
       
    59 Destructor
       
    60 */		
       
    61 CMTPImageDpGetObjectPropDesc::~CMTPImageDpGetObjectPropDesc()
       
    62     {	
       
    63     __FLOG(_L8(">> ~CMTPImageDpGetObjectPropDesc"));
       
    64     __FLOG(_L8(">> CMTPImageDpCopyObject::~CMTPImageDpCopyObject"));
       
    65     delete iObjectProperty;
       
    66     __FLOG(_L8("<< ~CMTPImageDpGetObjectPropDesc"));
       
    67     __FLOG_CLOSE;
       
    68     }
       
    69 
       
    70 /**
       
    71 Standard c++ constructor
       
    72 */	
       
    73 CMTPImageDpGetObjectPropDesc::CMTPImageDpGetObjectPropDesc(
       
    74                                     MMTPDataProviderFramework& aFramework,
       
    75                                     MMTPConnection& aConnection)
       
    76     :CMTPRequestProcessor(aFramework, aConnection, 0, NULL)
       
    77     {
       
    78     __FLOG_OPEN(KMTPSubsystem, KComponent);
       
    79     }
       
    80 
       
    81 /**
       
    82 check property code
       
    83 */
       
    84 TMTPResponseCode CMTPImageDpGetObjectPropDesc::CheckRequestL()
       
    85     {
       
    86     __FLOG(_L8(">> CMTPImageDpGetObjectPropDesc::CheckRequestL"));
       
    87     TMTPResponseCode response = CMTPRequestProcessor::CheckRequestL(); 
       
    88     TUint32 propCode = Request().Uint32(TMTPTypeRequest::ERequestParameter1);
       
    89     TUint32 formatCode = Request().Uint32(TMTPTypeRequest::ERequestParameter2);
       
    90 
       
    91     const TInt count = sizeof(KMTPImageDpSupportedProperties) / sizeof(TUint16);
       
    92     TInt i = 0;
       
    93     for(i = 0; i < count; i++)
       
    94         {
       
    95         if(KMTPImageDpSupportedProperties[i] == propCode)
       
    96             {
       
    97             break;
       
    98             }
       
    99         }
       
   100     if(i == count)
       
   101         {
       
   102         response = EMTPRespCodeInvalidObjectPropCode;
       
   103         }
       
   104 
       
   105     __FLOG(_L8("<< CMTPImageDpGetObjectPropDesc::CheckRequestL"));
       
   106     return response;	
       
   107     }
       
   108 
       
   109     
       
   110 /**
       
   111 GetObjectPropDesc request handler
       
   112 */	
       
   113 void CMTPImageDpGetObjectPropDesc::ServiceL()
       
   114     {
       
   115     delete iObjectProperty;
       
   116     iObjectProperty = NULL;	
       
   117     
       
   118     TUint32 propCode = Request().Uint32(TMTPTypeRequest::ERequestParameter1);
       
   119     __FLOG_VA((_L8(">> CMTPImageDpGetObjectPropDesc::ServiceL propcode %d"), propCode));	    
       
   120     switch(propCode)
       
   121         {
       
   122         case EMTPObjectPropCodeStorageID:
       
   123             ServiceStorageIdL();
       
   124             break;
       
   125         case EMTPObjectPropCodeObjectFormat:
       
   126             ServiceObjectFormatL();
       
   127             break;
       
   128         case EMTPObjectPropCodeProtectionStatus:
       
   129             ServiceProtectionStatusL();
       
   130             break;
       
   131         case EMTPObjectPropCodeObjectSize:
       
   132             ServiceObjectSizeL();
       
   133             break;
       
   134         case EMTPObjectPropCodeObjectFileName:
       
   135             ServiceFileNameL();
       
   136             break;
       
   137         case EMTPObjectPropCodeDateCreated:
       
   138             ServiceDateCreatedL();
       
   139             break;
       
   140         case EMTPObjectPropCodeDateModified:
       
   141             ServiceDateModifiedL();
       
   142             break;
       
   143         case EMTPObjectPropCodeParentObject:
       
   144             ServiceParentObjectL();
       
   145             break;
       
   146         case EMTPObjectPropCodePersistentUniqueObjectIdentifier:
       
   147             ServicePuidL();
       
   148             break;
       
   149         case EMTPObjectPropCodeName:
       
   150             ServiceNameL();
       
   151             break;
       
   152         case EMTPObjectPropCodeWidth:
       
   153             ServiceWidthL();
       
   154             break;
       
   155        case EMTPObjectPropCodeHeight:
       
   156             ServiceHeightL();
       
   157             break;
       
   158         case EMTPObjectPropCodeImageBitDepth:
       
   159             ServiceImageBitDepthL();
       
   160             break;
       
   161         case EMTPObjectPropCodeRepresentativeSampleFormat:
       
   162             ServiceRepresentativeSampleFormatL();
       
   163             break;
       
   164         case EMTPObjectPropCodeRepresentativeSampleSize:
       
   165             ServiceRepresentativeSampleSizeL();
       
   166             break;
       
   167         case EMTPObjectPropCodeRepresentativeSampleHeight:
       
   168             ServiceRepresentativeSampleHeightL();
       
   169             break;
       
   170         case EMTPObjectPropCodeRepresentativeSampleWidth:
       
   171             ServiceRepresentativeSampleWidthL();
       
   172             break;
       
   173         case EMTPObjectPropCodeNonConsumable:
       
   174             ServiceNonConsumableL();
       
   175             break;            
       
   176         default:
       
   177             {
       
   178             //Leave 
       
   179             User::Leave(KErrGeneral);
       
   180             }
       
   181             break;
       
   182         }
       
   183 
       
   184     __ASSERT_DEBUG(iObjectProperty, Panic(EMTPImageDpObjectPropertyNull));
       
   185     
       
   186     iObjectProperty->SetUint32L(CMTPTypeObjectPropDesc::EGroupCode, GetPropertyGroupNumber(propCode));
       
   187     SendDataL(*iObjectProperty);
       
   188 
       
   189     __FLOG(_L8("<< CMTPImageDpGetObjectPropDesc::ServiceL"));
       
   190     }
       
   191 
       
   192 
       
   193 /**
       
   194 Second-phase construction
       
   195 */			
       
   196 void CMTPImageDpGetObjectPropDesc::ConstructL()
       
   197     {	    
       
   198     }
       
   199         
       
   200 
       
   201 void CMTPImageDpGetObjectPropDesc::ServiceStorageIdL()
       
   202     {
       
   203     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeStorageID);	
       
   204     }
       
   205     
       
   206 void CMTPImageDpGetObjectPropDesc::ServiceObjectFormatL()
       
   207     {	
       
   208     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeObjectFormat);	
       
   209     }
       
   210     
       
   211 void CMTPImageDpGetObjectPropDesc::ServiceProtectionStatusL()
       
   212     {
       
   213     CMTPTypeObjectPropDescEnumerationForm* expectedForm = CMTPTypeObjectPropDescEnumerationForm::NewL(EMTPTypeUINT16);
       
   214     CleanupStack::PushL(expectedForm);
       
   215     //Currently, we only support EMTPProtectionNoProtection and EMTPProtectionReadOnly
       
   216 //  TUint16 values[] = {EMTPProtectionNoProtection, EMTPProtectionReadOnly, EMTPProtectionReadOnlyData, EMTPProtectionNonTransferable};
       
   217     TUint16 values[] = {EMTPProtectionNoProtection, EMTPProtectionReadOnly};
       
   218     TUint   numValues((sizeof(values) / sizeof(values[0])));
       
   219     for (TUint i = 0; i < numValues; i++)
       
   220         {
       
   221         TMTPTypeUint16 data(values[i]);
       
   222         expectedForm->AppendSupportedValueL(data);
       
   223         }  
       
   224     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeProtectionStatus, *expectedForm);      	
       
   225     CleanupStack::PopAndDestroy(expectedForm);
       
   226     }
       
   227     
       
   228 void CMTPImageDpGetObjectPropDesc::ServiceObjectSizeL()
       
   229     {
       
   230     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeObjectSize);	
       
   231     }
       
   232     
       
   233 void CMTPImageDpGetObjectPropDesc::ServiceFileNameL()
       
   234     {
       
   235     CMTPTypeString* form = CMTPTypeString::NewLC( KMtpObjDescObjFileName );
       
   236     // Althrough iObjectProperty is released in ServiceL(), release it here maybe a more safer way.
       
   237     if ( iObjectProperty != NULL )
       
   238 	    {
       
   239 	    delete iObjectProperty;
       
   240 	    iObjectProperty = NULL;
       
   241 	    }
       
   242 
       
   243     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeObjectFileName, CMTPTypeObjectPropDesc::ERegularExpressionForm, form);
       
   244 
       
   245     CleanupStack::PopAndDestroy( form );
       
   246     }
       
   247 
       
   248 void CMTPImageDpGetObjectPropDesc::ServiceDateCreatedL()
       
   249     {
       
   250     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   251     info.iDataType     = EMTPTypeString;
       
   252     info.iFormFlag     = CMTPTypeObjectPropDesc::EDateTimeForm;
       
   253     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   254     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeDateCreated, info, NULL);
       
   255     }
       
   256     
       
   257 void CMTPImageDpGetObjectPropDesc::ServiceDateModifiedL()
       
   258     {
       
   259     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeDateModified);
       
   260     }
       
   261     
       
   262 void CMTPImageDpGetObjectPropDesc::ServiceParentObjectL()
       
   263     {
       
   264     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeParentObject);
       
   265     }
       
   266     
       
   267 void CMTPImageDpGetObjectPropDesc::ServicePuidL()
       
   268     {
       
   269     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodePersistentUniqueObjectIdentifier);
       
   270     }
       
   271     
       
   272 void CMTPImageDpGetObjectPropDesc::ServiceNameL()
       
   273     {
       
   274     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeName);	
       
   275     }
       
   276     
       
   277 void CMTPImageDpGetObjectPropDesc::ServiceWidthL()
       
   278     {    
       
   279     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   280     info.iDataType     = EMTPTypeUINT32;
       
   281     info.iFormFlag     = CMTPTypeObjectPropDesc::ERangeForm;
       
   282     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   283    
       
   284     CMTPTypeObjectPropDescRangeForm* expectedForm = CMTPTypeObjectPropDescRangeForm::NewLC(EMTPTypeUINT32);
       
   285 
       
   286     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMinimumValue, 0x00000001);
       
   287     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMaximumValue, 0x20000000);
       
   288     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EStepSize, 0x00000001);
       
   289     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeWidth, info, expectedForm);
       
   290     CleanupStack::PopAndDestroy(expectedForm);
       
   291     }
       
   292 
       
   293 void CMTPImageDpGetObjectPropDesc::ServiceHeightL()
       
   294     {
       
   295     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   296     info.iDataType     = EMTPTypeUINT32;
       
   297     info.iFormFlag     = CMTPTypeObjectPropDesc::ERangeForm;
       
   298     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   299     
       
   300     CMTPTypeObjectPropDescRangeForm* expectedForm = CMTPTypeObjectPropDescRangeForm::NewLC(EMTPTypeUINT32);
       
   301 
       
   302     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMinimumValue, 0x00000001);
       
   303     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMaximumValue, 0x20000000);
       
   304     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EStepSize, 0x00000001);
       
   305     
       
   306     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeHeight, info, expectedForm);
       
   307     
       
   308     CleanupStack::PopAndDestroy(expectedForm);    
       
   309     }
       
   310 
       
   311 void CMTPImageDpGetObjectPropDesc::ServiceImageBitDepthL()
       
   312     {
       
   313     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   314     info.iDataType     = EMTPTypeUINT32;
       
   315     info.iFormFlag     = CMTPTypeObjectPropDesc::ERangeForm;
       
   316     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   317     
       
   318     CMTPTypeObjectPropDescRangeForm* expectedForm = CMTPTypeObjectPropDescRangeForm::NewLC(EMTPTypeUINT32);
       
   319 
       
   320     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMinimumValue, 0x00000001);
       
   321     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMaximumValue, 0x20000000);
       
   322     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EStepSize, 0x00000001);
       
   323     
       
   324     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeImageBitDepth, info, expectedForm);
       
   325     
       
   326     CleanupStack::PopAndDestroy(expectedForm); 
       
   327     
       
   328     //to do: deine the Group code
       
   329     //iObjectProperty->SetUint32L(CMTPTypeObjectPropDesc::EGroupCode, 1);
       
   330     }
       
   331 
       
   332 void CMTPImageDpGetObjectPropDesc::ServiceRepresentativeSampleFormatL()
       
   333     {
       
   334     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   335     info.iDataType     = EMTPTypeUINT16;
       
   336     info.iFormFlag     = CMTPTypeObjectPropDesc::EEnumerationForm;
       
   337     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   338     
       
   339     CMTPTypeObjectPropDescEnumerationForm* expectedForm = CMTPTypeObjectPropDescEnumerationForm::NewL(EMTPTypeUINT16);
       
   340     CleanupStack::PushL(expectedForm);
       
   341     TUint16 values[] = {EMTPFormatCodeEXIFJPEG};
       
   342     TUint   numValues((sizeof(values) / sizeof(values[0])));
       
   343     for (TUint i = 0; i < numValues; i++)
       
   344         {
       
   345         TMTPTypeUint16 data(values[i]);
       
   346         expectedForm->AppendSupportedValueL(data);
       
   347         }  
       
   348     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeRepresentativeSampleFormat, info, expectedForm);
       
   349     
       
   350     CleanupStack::PopAndDestroy(expectedForm);
       
   351     }
       
   352 
       
   353 void CMTPImageDpGetObjectPropDesc::ServiceRepresentativeSampleSizeL()
       
   354     {
       
   355     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   356     info.iDataType     = EMTPTypeUINT32;
       
   357     info.iFormFlag     = CMTPTypeObjectPropDesc::ERangeForm;
       
   358     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   359     
       
   360     CMTPTypeObjectPropDescRangeForm* expectedForm = CMTPTypeObjectPropDescRangeForm::NewLC(EMTPTypeUINT32);
       
   361 
       
   362     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMinimumValue, 0x00000001);
       
   363     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMaximumValue, 0x20000000);
       
   364     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EStepSize, 0x00000001);
       
   365     
       
   366     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeRepresentativeSampleSize, info, expectedForm);
       
   367     
       
   368     CleanupStack::PopAndDestroy(expectedForm); 
       
   369     }
       
   370 
       
   371 void CMTPImageDpGetObjectPropDesc::ServiceRepresentativeSampleHeightL()
       
   372     {
       
   373     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   374     info.iDataType     = EMTPTypeUINT32;
       
   375     info.iFormFlag     = CMTPTypeObjectPropDesc::ERangeForm;
       
   376     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   377     
       
   378     CMTPTypeObjectPropDescRangeForm* expectedForm = CMTPTypeObjectPropDescRangeForm::NewLC(EMTPTypeUINT32);
       
   379     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMinimumValue, 0x00000001);
       
   380     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMaximumValue, 0x20000000);
       
   381     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EStepSize, 0x00000001);
       
   382     
       
   383     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeRepresentativeSampleHeight, info, expectedForm);
       
   384     
       
   385     CleanupStack::PopAndDestroy(expectedForm);   
       
   386      
       
   387     }
       
   388 
       
   389 void CMTPImageDpGetObjectPropDesc::ServiceRepresentativeSampleWidthL()
       
   390     {
       
   391     CMTPTypeObjectPropDesc::TPropertyInfo info;
       
   392     info.iDataType     = EMTPTypeUINT32;
       
   393     info.iFormFlag     = CMTPTypeObjectPropDesc::ERangeForm;
       
   394     info.iGetSet       = CMTPTypeObjectPropDesc::EReadOnly;
       
   395     
       
   396     CMTPTypeObjectPropDescRangeForm* expectedForm = CMTPTypeObjectPropDescRangeForm::NewLC(EMTPTypeUINT32);
       
   397 
       
   398     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMinimumValue, 0x00000001);
       
   399     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EMaximumValue, 0x20000000);
       
   400     expectedForm->SetUint32L(CMTPTypeObjectPropDescRangeForm::EStepSize, 0x00000001);
       
   401     
       
   402     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeRepresentativeSampleWidth, info, expectedForm);
       
   403     
       
   404     CleanupStack::PopAndDestroy(expectedForm);
       
   405     }
       
   406 
       
   407 void CMTPImageDpGetObjectPropDesc::ServiceNonConsumableL()
       
   408     {
       
   409     CMTPTypeObjectPropDescEnumerationForm* expectedForm = CMTPTypeObjectPropDescEnumerationForm::NewL(EMTPTypeUINT8);
       
   410     CleanupStack::PushL(expectedForm);
       
   411     TUint8 values[] = {0,1};
       
   412     TUint   numValues((sizeof(values) / sizeof(values[0])));
       
   413     for (TUint i = 0; i < numValues; i++)
       
   414         {
       
   415         TMTPTypeUint8 data(values[i]);
       
   416         expectedForm->AppendSupportedValueL(data);
       
   417         }   
       
   418     iObjectProperty = CMTPTypeObjectPropDesc::NewL(EMTPObjectPropCodeNonConsumable, *expectedForm);     
       
   419     CleanupStack::PopAndDestroy(expectedForm);
       
   420     }
       
   421 
       
   422 TUint16 CMTPImageDpGetObjectPropDesc::GetPropertyGroupNumber(const TUint16 aPropCode) const
       
   423     {
       
   424     for( TInt propCodeIndex = 0 ; propCodeIndex < KMTPImageDpGroupOneSize ; propCodeIndex++)
       
   425         {
       
   426             if(KMTPImageDpGroupOneProperties[propCodeIndex] == aPropCode)
       
   427                 {
       
   428                 return KMTPImageDpPropertyGroupOneNumber;
       
   429                 }
       
   430         }
       
   431     
       
   432     // if not foud, the group number should be 0.
       
   433     return 0;
       
   434     }