fullpathname.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. #pragma once
  36. #include "hxstring.h"
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  40. #if defined(_MAC_UNIX) || defined(_CARBON)
  41. // 8-bit encodings:
  42. //   HFS path is in system encoding (required by Metrowerks libraries)
  43. //   POSIX path is in UTF8 encoding (prefs assumes system encoding so this can't be saved)
  44. //   URLs are percent-escaped
  45. // HFS path <--> FSRef
  46. OSErr HFSPathFromFSRef(const FSRef *ref, CHXString& fullPathName);
  47. OSErr FSRefFromHFSPath(const char *path, FSRef *outRef);
  48. // HFS path <--> URL
  49. OSStatus URLFromHFSPath(const char *pszPath, CHXString& strURL);
  50. OSStatus HFSPathFromURL(const char *pszURL, CHXString& fullPathName);
  51. // "Current" path type (HFS on CFM builds, POSIX on Mach-O builds)
  52. OSErr PathFromFSRef(const FSRef *ref, CHXString& fullPathName);
  53. OSErr FSRefFromPath(const char *path, FSRef *outRef);
  54. OSErr PathFromURL(const char *pszURL, CHXString& fullPathName);
  55. OSErr URLFromPath(const char *pszPath, CHXString& strURL);
  56. CFStringEncoding CurrentPathEncoding();
  57. // POSIX path <--> FSRef (POSIX path is in UTF8 encoding)
  58. OSStatus POSIXPathFromFSRef(const FSRef *ref, CHXString &fullPathName);
  59. OSStatus FSRefFromPosixPath (const char *pszPath, FSRef *pRef);
  60. // POSIX path <--> URL
  61. OSStatus URLFromPOSIXPath(const char *pszPath, CHXString& strURL);
  62. OSStatus POSIXPathFromURL(const char *pszURL, CHXString& fullPathName);
  63. // HFS partial <--> full path name (hopefully never needed)
  64. OSErr FullFromPartialHFSPath(const char *pszPartialOrFullPath, CHXString& fullPathName);
  65. OSErr FullFromPartialPOSIXPath(const char *pszPartialOrFullPath, CHXString& fullPathName);
  66. #endif // _CARBON
  67. // Deprecated routines
  68. //
  69. // These are old HFS path routines; these should not be used under Carbon since they
  70. // will fail on long filenames
  71. OSErr PathNameFromDirID(long dirID, short vRefNum, CHXString &fullPathName);
  72. OSErr PathNameFromWD(long vRefNum, CHXString &pathName);
  73. OSErr PathNameFromFSSpec(const FSSpec* fsSpec, CHXString &fullPathName);
  74. OSErr FSSpecFromPathName(const char *path, FSSpecPtr spec);
  75. #ifdef __cplusplus
  76. }
  77. #endif