LibreOffice
LibreOffice 24.2 SDK C/C++ API Reference
Type.h
Go to the documentation of this file.
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3  * This file is part of the LibreOffice project.
4  *
5  * This Source Code Form is subject to the terms of the Mozilla Public
6  * License, v. 2.0. If a copy of the MPL was not distributed with this
7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8  *
9  * This file incorporates work covered by the following license notice:
10  *
11  * Licensed to the Apache Software Foundation (ASF) under one or more
12  * contributor license agreements. See the NOTICE file distributed
13  * with this work for additional information regarding copyright
14  * ownership. The ASF licenses this file to you under the Apache
15  * License, Version 2.0 (the "License"); you may not use this file
16  * except in compliance with the License. You may obtain a copy of
17  * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18  */
19 
20 /*
21  * This file is part of LibreOffice published API.
22  */
23 #ifndef INCLUDED_COM_SUN_STAR_UNO_TYPE_H
24 #define INCLUDED_COM_SUN_STAR_UNO_TYPE_H
25 
27 #include "com/sun/star/uno/TypeClass.hdl"
28 #include "rtl/ustring.hxx"
29 #include "rtl/alloc.h"
30 
31 
32 namespace com
33 {
34 namespace sun
35 {
36 namespace star
37 {
38 namespace uno
39 {
40 
44 {
49 };
50 
58 class SAL_WARN_UNUSED SAL_DLLPUBLIC_RTTI Type
59 {
63 
64 public:
66  // these are here to force memory de/allocation to sal lib.
67  static void * SAL_CALL operator new ( size_t nSize )
68  { return ::rtl_allocateMemory( nSize ); }
69  static void SAL_CALL operator delete ( void * pMem )
70  { ::rtl_freeMemory( pMem ); }
71  static void * SAL_CALL operator new ( size_t, void * pMem )
72  { return pMem; }
73  static void SAL_CALL operator delete ( void *, void * )
74  {}
76 
79  inline Type();
80 
86  inline Type( TypeClass eTypeClass, const ::rtl::OUString & rTypeName );
87 
93  inline Type( TypeClass eTypeClass, const char * pTypeName );
94 
99  inline Type( typelib_TypeDescriptionReference * pType );
100 
114  inline Type( typelib_TypeDescriptionReference * pType, __sal_NoAcquire dummy );
115 
120  inline Type( const Type & rType );
121 
126 
132  inline Type & SAL_CALL operator = ( const Type & rType );
133 
134 #if defined LIBO_INTERNAL_ONLY
135  inline Type & SAL_CALL operator = ( Type && );
136 #endif
137 
142  TypeClass SAL_CALL getTypeClass() const
143  { return static_cast<TypeClass>(_pType->eTypeClass); }
144 
149  inline ::rtl::OUString SAL_CALL getTypeName() const;
150 
155  void SAL_CALL getDescription( typelib_TypeDescription ** ppDescr ) const
157 
163  { return _pType; }
164 
173  bool SAL_CALL isAssignableFrom( const Type & rType ) const
175 
181  bool SAL_CALL equals( const Type & rType ) const
182  { return ::typelib_typedescriptionreference_equals( _pType, rType._pType ); }
188  bool SAL_CALL operator == ( const Type & rType ) const
189  { return ::typelib_typedescriptionreference_equals( _pType, rType._pType ); }
195  bool SAL_CALL operator != ( const Type & rType ) const
196  { return (! ::typelib_typedescriptionreference_equals( _pType, rType._pType )); }
197 };
198 
201 template< class T >
202 class Array
203 {
204 public:
206 };
207 
208 }
209 }
210 }
211 }
212 
225 SAL_DEPRECATED("use cppu::UnoType")
226 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const ::com::sun::star::uno::Type * );
227 
234 SAL_DEPRECATED("use cppu::UnoType")
235 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuVoidType();
243 SAL_DEPRECATED("use cppu::UnoType")
244 inline const ::com::sun::star::uno::Type & SAL_CALL getVoidCppuType();
245 
253 SAL_DEPRECATED("use cppu::UnoType")
254 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuBooleanType();
262 SAL_DEPRECATED("use cppu::UnoType")
263 inline const ::com::sun::star::uno::Type & SAL_CALL getBooleanCppuType();
276 SAL_DEPRECATED("use cppu::UnoType")
277 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_Bool * );
290 SAL_DEPRECATED("use cppu::UnoType")
291 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType(
292  bool const * );
293 
301 SAL_DEPRECATED("use cppu::UnoType")
302 inline const ::com::sun::star::uno::Type & SAL_CALL getCharCppuType();
310 SAL_DEPRECATED("use cppu::UnoType")
311 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuCharType();
312 
325 SAL_DEPRECATED("use cppu::UnoType")
326 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_Int8 * );
327 
340 SAL_DEPRECATED("use cppu::UnoType")
341 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const ::rtl::OUString * );
342 
355 SAL_DEPRECATED("use cppu::UnoType")
356 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_Int16 * );
357 
370 SAL_DEPRECATED("use cppu::UnoType")
371 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_uInt16 * );
372 
385 SAL_DEPRECATED("use cppu::UnoType")
386 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_Int32 * );
387 
400 SAL_DEPRECATED("use cppu::UnoType")
401 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_uInt32 * );
402 
415 SAL_DEPRECATED("use cppu::UnoType")
416 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_Int64 * );
417 
430 SAL_DEPRECATED("use cppu::UnoType")
431 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const sal_uInt64 * );
432 
445 SAL_DEPRECATED("use cppu::UnoType")
446 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const float * );
447 
460 SAL_DEPRECATED("use cppu::UnoType")
461 inline const ::com::sun::star::uno::Type & SAL_CALL getCppuType( const double * );
462 
481 template< typename T > SAL_DEPRECATED("use cppu::UnoType")
482 inline const ::com::sun::star::uno::Type & SAL_CALL
483 getCppuType();
484 
496 template<> SAL_DEPRECATED("use cppu::UnoType")
497 inline const ::com::sun::star::uno::Type & SAL_CALL
499 
500 #endif
501 
502 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
bool equals(const Type &rType) const
Compares two types.
Definition: Type.h:181
const ::com::sun::star::uno::Type & getCppuVoidType()
Gets the meta type of IDL type void.
Definition: Type.hxx:130
static typelib_TypeDescriptionReference * s_pType
Definition: Type.h:205
const ::com::sun::star::uno::Type & getBooleanCppuType()
Gets the meta type of IDL type boolean.
Definition: Type.hxx:143
const ::com::sun::star::uno::Type & getCppuCharType()
Gets the meta type of IDL type char.
Definition: Type.hxx:162
signed char sal_Int8
Definition: types.h:43
const ::com::sun::star::uno::Type & getCppuType(const ::com::sun::star::uno::Type *)
Gets the meta type of IDL type "type".
typelib_TypeDescriptionReference * getTypeLibType() const
Gets the C typelib type description reference pointer.
Definition: Type.h:162
bool operator!=(const Any &rAny, const C &value)
Template inequality operator: compares set value of left side any to right side value.
Definition: Any.hxx:675
bool isAssignableFrom(const Type &rType) const
Tests if values of this reflected type can be assigned by values of given type.
Definition: Type.h:173
bool operator==(const Any &rAny, const C &value)
Template equality operator: compares set value of left side any to right side value.
Definition: Any.hxx:664
struct SAL_DLLPUBLIC_RTTI _typelib_TypeDescriptionReference typelib_TypeDescriptionReference
Holds a weak reference to a type description.
#define SAL_DEPRECATED(message)
Use as follows: SAL_DEPRECATED("Don&#39;t use, it&#39;s evil.") void doit(int nPara);.
Definition: types.h:474
#define SAL_WARN_UNUSED
Annotate classes where a compiler should warn if an instance is unused.
Definition: types.h:587
TypeClass getTypeClass() const
Gets the type class of set type.
Definition: Type.h:142
SAL_DLLPUBLIC void * rtl_allocateMemory(sal_Size Bytes) SAL_THROW_EXTERN_C()
Allocate memory.
CPPU_DLLPUBLIC sal_Bool typelib_typedescriptionreference_isAssignableFrom(typelib_TypeDescriptionReference *pAssignable, typelib_TypeDescriptionReference *pFrom) SAL_THROW_EXTERN_C()
Tests if values of type pAssignable can be assigned by values of type pFrom.
CPPU_DLLPUBLIC void typelib_typedescriptionreference_getDescription(typelib_TypeDescription **ppRet, typelib_TypeDescriptionReference *pRef) SAL_THROW_EXTERN_C()
Retrieves the type description for a given reference.
rtl::OUString getTypeName(rtl::OUString const &rEnvDcp)
Get the OBI type part of an environment descriptor.
Definition: EnvDcp.hxx:41
Definition: types.h:359
sal_uInt16 sal_Unicode
Definition: types.h:123
UnoType_NoAcquire
Enum defining UNO_TYPE_NO_ACQUIRE for type description reference transfer.
Definition: Type.h:43
void getDescription(typelib_TypeDescription **ppDescr) const
Obtains a full type description of set type.
Definition: Type.h:155
unsigned char sal_Bool
Definition: types.h:38
__sal_NoAcquire
Definition: types.h:352
struct SAL_DLLPUBLIC_RTTI _typelib_TypeDescription typelib_TypeDescription
Full type description of a type.
Definition: bootstrap.hxx:33
Definition: Enterable.hxx:30
CPPU_DLLPUBLIC void typelib_typedescriptionreference_release(typelib_TypeDescriptionReference *pRef) SAL_THROW_EXTERN_C()
Increments reference count of type description reference.
const ::com::sun::star::uno::Type & getCppuBooleanType()
Gets the meta type of IDL type boolean.
Definition: Type.hxx:139
Helper class to specify a type pointer for idl arrays.
Definition: Type.h:202
~Type()
Destructor: Releases acquired C type description reference.
Definition: Type.h:124
SAL_DLLPUBLIC void rtl_freeMemory(void *Ptr) SAL_THROW_EXTERN_C()
Free memory.
CPPU_DLLPUBLIC sal_Bool typelib_typedescriptionreference_equals(const typelib_TypeDescriptionReference *p1, const typelib_TypeDescriptionReference *p2) SAL_THROW_EXTERN_C()
Tests whether two types description references are equal, i.e.
This enum value can be used for creating a Type object granting a given type description reference...
Definition: Type.h:48
const ::com::sun::star::uno::Type & getCharCppuType()
Gets the meta type of IDL type char.
Definition: Type.hxx:158
const ::com::sun::star::uno::Type & getVoidCppuType()
Gets the meta type of IDL type void.
Definition: Type.hxx:134
C++ class representing an IDL meta type.
Definition: Type.h:58