smbmusicaplibscrew.h

索爱手机代码

/* Copyright (C) 2006 Sony Ericsson Mobile Communications Japan, Inc. */
/*--------------------------------------------------------------------*/
// FileName:
//	SmbMusicAPLibScrew.h
//
// Description:
//	PTX810 Music傾僾儕 儈儏乕僕僢僋傾僾儕儔僀僽儔儕
/*--------------------------------------------------------------------*/
//曄峏棜楌
//擔晅			|曄峏幰			|撪梕
//--------------+---------------+--------------------------------------
//2006/09/23	|SEMC崃绮		|僼傽僀儖僔僗僥儉嫟捠儔僀僽儔儕偐傜愗傝弌偟

/** @file SmbMusicAPLibScrew.h
 *  斈梡偩偑摿壔栚揑偺僱僕僋僊晹昳孮丅
 *
 *  揔梡儗僀儎傪尷掕偟側偄偲偄偆揰偱偼斈梡偩偑丄栚揑偑
 *      - 揇廘偄
 *      - 挻摿壔
 *
 *  側彫昳偺廤傑傝丅
 *
 *  @note   杮僿僢僟僼傽僀儖偵擖傟傞晹昳偼丄昁偢 inline 偲偡傞偙偲丅
 *
 *  $Revision: 1.2 $ $Date: 2006/04/05 17:21:27 $
 */

#ifndef __SMBMUSICAPLIB_SCREW_H__
#define __SMBMUSICAPLIB_SCREW_H__

#include    "SmbMusicAPLibConfig.h"

SEMCJ_NAMESPACE_BEGIN
MUSICAPLIB_NAMESPACE_BEGIN

/**
 *  僆僽僕僃僋僩 delete 帪偺掕宆僐乕僪傪僇僾僙儖丅
 *
 *  擇廳delete傪杊偖偨傔偺掕宆僀僨傿僆儉僐乕僪(delete & nullify)傪幚峴偡傞丅
 *
 *  @param[in]  aPtr    new墘嶼巕偱妋曐偝傟偨擟堄偺 heap object 傪巜偡億僀儞僞傊偺嶲徠丅
 *  @post       aPtr 偑巜偟偰偄偨僆僽僕僃僋僩偵 delete 墘嶼巕偑揔梡偝傟偨丅
 *  @post       aPtr 偺抣偼 0(NULL) 偵側偭偰偄傞丅
 */
template<typename T>
void DeleteAndNullify( T*& aPtr );

/**
 *  HBufC宯偺僒僀僘曄峏帪偺掕宆僐乕僪傪僇僾僙儖丅
 *
 *  HBufC宯僆僽僕僃僋僩 realloc 帪偵丄儊儌儕晄懌帪儕乕僋懳嶔偲偟偰丄儚儞僷僞乕儞偵昁梫偲側傞掕宆僐乕僪傪廤栺偡傞丅
 *      -# CleanupStack 偵僒僀僘曄峏懳徾僆僽僕僃僋僩傪愊傓丅
 *      -# ReAllocL() 傪幚峴丅
 *      -# 婋尟側 L* 偑廔傢偭偨偺偱 CleanupStack 偐傜堦偮崀傠偡丅
 *
 *  杮僥儞僾儗乕僩娭悢偼丄屻抜偺俀庤弴偺傒傪幚峴偡傞丅
 *
 *  @param[in]  aPtr        僒僀僘曄峏偟偨偄懳徾僆僽僕僃僋僩傊偺億僀儞僞丅
 *  @param[in]  aMaxLength  see HBufC::AllocL()
 *  @return 僒僀僘曄峏偝傟偨僆僽僕僃僋僩(仸傾僪儗僗偼曄傢偭偰偄傞壜擻惈偑偁傞)丅
 *  @pre    aPtr 偑 CleanupStack top 偵愊傑傟偰偄傞丅
 *  @post   aPtr 偼 CleanupStack 偐傜崀傠偝傟偰偄傞丅
 *  @note   僥儞僾儗乕僩娭悢偵偟偨偺偼丄HBufC8, HBufC16 偺 2 class 偵揔梡壜偲偟偨偄偐傜丅
 */
template<typename T>
T ReAllocAndPopL( T aPtr, TInt aMaxLength );

/**
 *  HBufC宯偺僒僀僘曄峏帪偺掕宆僐乕僪傪僇僾僙儖丅
 *
 *  HBufC宯僆僽僕僃僋僩 realloc 帪偵丄儊儌儕晄懌帪儕乕僋懳嶔偲偟偰丄儚儞僷僞乕儞偵昁梫偲側傞掕宆僐乕僪傪廤栺偡傞丅
 *  ReAllocAndPopL() 偵丄埲壓偺屻懕堦庤傪壛偊偨偩偗偺傕偺丅
 *      -# 僒僀僘曄峏屻偺僆僽僕僃僋僩傪夵傔偰 CleanupStack::PushL() 偡傞丅
 *
 *  @param[in]  aPtr        僒僀僘曄峏偟偨偄懳徾僆僽僕僃僋僩傊偺億僀儞僞丅
 *  @param[in]  aMaxLength  see HBufC::AllocL()
 *  @return 僒僀僘曄峏偝傟偨僆僽僕僃僋僩(仸傾僪儗僗偼曄傢偭偰偄傞壜擻惈偑偁傞)丅
 *  @pre    aPtr 偑 CleanupStack top 偵愊傑傟偰偄傞丅
 *  @post   aPtr 偼 CleanupStack 偐傜崀傠偝傟丄top 偼栠傝抣偱曉偡僆僽僕僃僋僩偵曄傢偭偰偄傞丅
 *  @note   僥儞僾儗乕僩娭悢偵偟偨偺偼丄HBufC8, HBufC16 偺 2 class 偵揔梡壜偲偟偨偄偐傜丅
 */
template<typename T>
T ReAllocAndReplacePushLC( T aPtr, TInt aMaxLength );

/**
 *  嵍曈抣嬮宍偑塃曈抣嬮宍傪姰慡偵娷傓偐傪敾掕丅
 *
 *  @param[in]  aLhs    嵍曈抣嬮宍丅
 *  @param[in]  aRhs    塃曈抣嬮宍丅
 *  @return @a aLhs 偑 @a aRhs 傪姰慡偵曪娷偟偰偄傞側傜恀傪丄偦偆偱側偗傟偽婾傪曉偡丅
 *  @note   TBool TRect::Contains(const TRect&) const 偑側偤偐懚嵼偟側偄偺偱丄傗傓側偔掕媊丅
 */
TBool Contains( const TRect& aLhs, const TRect& aRhs );
/**
 *  嵍曈抣嬮宍偲塃曈抣嬮宍偺岎嵎嬮宍傪曉偡丅
 *
 *  @param[in]  aLhs    嵍曈抣嬮宍丅
 *  @param[in]  aRhs    塃曈抣嬮宍丅
 *  @return @a aLhs 偲 @a aRhs 偺岎嵎偡傞嫟捠晹暘偺嬮宍丅
 *  @note   TRect::Intersection(const TRect&) 偑帺屓峏怴宆(栠傝抣偱曉偝側偄)偱丄巊偄偯傜偄偙偲偑懡偄偺偱丄傗傓側偔掕媊丅
 */
const TRect Intersection( const TRect& aLhs, const TRect& aRhs );
/**
 *  嵍曈抣嬮宍偲塃曈抣嬮宍偺寢崌嬮宍傪曉偡丅
 *
 *  @param[in]  aLhs    嵍曈抣嬮宍丅
 *  @param[in]  aRhs    塃曈抣嬮宍丅
 *  @return @a aLhs 偲 @a aRhs 偺椉曽傪娷傓嵟彫偺嬮宍丅
 *  @note   TRect::BoundingRect(const TRect&) 偑帺屓峏怴宆(栠傝抣偱曉偝側偄)偱丄巊偄偯傜偄偙偲偑懡偄偺偱丄傗傓側偔掕媊丅
 */
const TRect Union( const TRect& aLhs, const TRect& aRhs );
/**
 *  巜掕嬮宍傪巜掕嫍棧堏摦偝偣偨嬮宍傪曉偡丅
 *
 *  @param[in]  aRect   懳徾嬮宍丅
 *  @param[in]  aDist   堏摦嫍棧丅
 *  @return @a aRect 傪 @a aDist 埵抲堏摦偝偣偨嬮宍丅
 *  @note   TRect::Move(const TPoint&) 偑帺屓峏怴宆(栠傝抣偱曉偝側偄)偱丄巊偄偯傜偄偙偲偑懡偄偺偱丄傗傓側偔掕媊丅
 */
const TRect Moved( const TRect& aRect, const TPoint& aDist );

/**
 *  僨傿僗僋儕僾僞偺彂偒崬傒偁傆傟懳嶔梡 No operation 僴儞僪儔丅
 *
 *  AppendFormat(), AppendFormatList() 偵搉偣傞丄乽壗傕偟側偄乿僴儞僪儔丅<br>
 *  僨傿僗僋儕僾僞偺乽偁傆傟傞帪偵偼Panic()偡傞乿偲偄偆捠忢偺怳傞晳偄傪巭傔偨偄偩偗偺栚揑側傜偽丄
 *  杮僆僽僕僃僋僩偱梡偑懌傝傞丅
 *
 *  @see    TDes8::AppendFormat(), TDes8::AppendFormatList()
 *  @see    TDes16::AppendFormat(), TDes16::AppendFormatList()
 *  @note   TDes8, TDes16 偦傟偧傟梡偵僋儔僗傪愝偗偨偔側偄偺偱丄椉幰偺梫媮乻interface乼傪幚憰偟偰偄傞丅
 */
class TSmbMusicAPLib_Noop4DesOverflow : public TDes8Overflow
                              , public TDes16Overflow
{
private:
    /**
     *  8 bit 僨傿僗僋儕僾僞梡丅
     *
     *  @param[in,out]  aDes    see TDes8Overflow::Overflow(), 杮僋儔僗偱偼巊梡偟側偄丅
     */
    void Overflow( TDes8& aDes );
    /**
     *  16 bit 僨傿僗僋儕僾僞梡丅
     *
     *  @param[in,out]  aDes    see TDes16Overflow::Overflow(), 杮僋儔僗偱偼巊梡偟側偄丅
     */
    void Overflow( TDes16& aDes );
};

MUSICAPLIB_NAMESPACE_END
SEMCJ_NAMESPACE_END

#include    "SmbMusicAPLibScrew.inl"

#endif  // __SMBMUSICAPLIB_SCREW_H__

/* Copyright (C) 2006 Sony Ericsson Mobile Communications Japan, Inc. */