hxparse.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:4k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef __HXPARSE_H
  36. #define __HXPARSE_H
  37. /****************************************************************************
  38.  *  HXParseColor
  39.  *
  40.  *  Parses a smil/html color string and returns its HXxColor value.  The
  41.  *  string should be in one of the following formats: "#RGB", "#RRGGBB",
  42.  *  or one of the pre-defined strings in the table at the top of this file.
  43.  */
  44. HX_RESULT HXParseColor(const char* pColorString, REF(HXxColor) theColor);
  45. /****************************************************************************
  46.  *  HXParseDigit
  47.  *
  48.  *  Parses an integer digit, returning an error if the entire string is not
  49.  *  a digit.  The function uses atol for the actual conversion:
  50.  *  [whitespace][sign]digits
  51.  */
  52. HX_RESULT HXParseDigit(const char* pDigitString, REF(INT32) ulOut);
  53. /****************************************************************************
  54.  *  HXParseDouble
  55.  *
  56.  *  Parses an double value, returning an error if the entire string is not
  57.  *  a valid value.  The function uses atof for the actual conversion:
  58.  *  [whitespace] [sign] [digits] [.digits] [ {d | D | e | E}[sign]digits]
  59.  */
  60. HX_RESULT HXParseDouble(const char* pDigitString, REF(double) dOut);
  61. /****************************************************************************
  62.  *  HXParseColorUINT32
  63.  *
  64.  *  Same as HXParseColor, but it produces the same UINT32 on all platforms.
  65.  *  HXParseColor produces 0x00BBGGRR on Windows and 0x00RRGGBB on non-Windows.
  66.  */
  67. HX_RESULT HXParseColorUINT32(const char* pszStr, REF(UINT32) rulValue);
  68. /****************************************************************************
  69.  *  HXParsePercent
  70.  *
  71.  *  Parses a percent value, returning an error if the entire string is not
  72.  *  a valid value. The string should be: <double> '%' and the '%' must be
  73.  *  present.
  74.  */
  75. HX_RESULT HXParsePercent(const char* pszStr, REF(double) rdValue);
  76. /****************************************************************************
  77.  *  HXParseUINT32
  78.  *
  79.  *  Parses an unsigned integer digit, returning an error if the entire
  80.  *  string is not a digit.  The function uses strtoul for the actual conversion:
  81.  *  [whitespace]digits
  82.  */
  83. HX_RESULT HXParseUINT32(const char* pszStr, REF(UINT32) rulValue);
  84. /****************************************************************************
  85.  *  HXParseOpacity
  86.  *
  87.  *  Opacity can be expressed as a [0-255] value or as a percent. This method
  88.  *  attempts to parse as a percent and then if it's not able, it parses as
  89.  *  a UINT32. The final value is clamped to be in the range [0-255].
  90.  */
  91. HX_RESULT HXParseOpacity(const char* pszStr, REF(UINT32) rulValue);
  92. #endif