INTEGRATION: CWS cliuno01 (1.16.24); FILE MERGED

2003/09/01 14:30:06 dbo 1.16.24.2: RESYNC: (1.16-1.17); FILE MERGED
2003/06/05 09:24:57 dbo 1.16.24.1: #107130# adding unacquired()

1 files changed, 16 insertions, 2 deletions

diff --git a/sal/inc/rtl/ustring.hxx b/sal/inc/rtl/ustring.hxx
index 4e7e7c5178aa..6bc583ae8e41 100644
--- a/sal/inc/rtl/ustring.hxx
+++ b/sal/inc/rtl/ustring.hxx
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: ustring.hxx,v $
  *
- *  $Revision: 1.17 $
+ *  $Revision: 1.18 $
  *
- *  last change: $Author: hr $ $Date: 2003-08-07 14:56:46 $
+ *  last change: $Author: obo $ $Date: 2003-09-04 10:56:15 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -226,6 +226,20 @@ public:
         rtl_uString_release( pData );
     }
 
+    /** Provides an OUString const & passing a storage pointer of an
+        rtl_uString * handle.
+        It is more convenient to use C++ OUString member functions when dealing
+        with rtl_uString * handles.  Using this function avoids unnecessary
+        acquire()/release() calls for a temporary OUString object.
+
+        @param ppHandle
+               pointer to storage
+        @return
+               OUString const & based on given storage
+    */
+    static inline OUString const & unacquired( rtl_uString * const * ppHandle )
+        { return * reinterpret_cast< OUString const * >( ppHandle ); }
+
     /**
       Assign a new string.