blpapi_types.h

Go to the documentation of this file.

/* Copyright 2012. Bloomberg Finance L.P.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to
 * deal in the Software without restriction, including without limitation the
 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 * sell copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:  The above
 * copyright notice and this permission notice shall be included in all copies
 * or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 * IN THE SOFTWARE.
 */

#ifndef INCLUDED_BLPAPI_TYPES
#define INCLUDED_BLPAPI_TYPES

typedef int blpapi_Bool_t;
typedef char blpapi_Char_t;
typedef unsigned char blpapi_UChar_t;
typedef short blpapi_Int16_t;
typedef unsigned short blpapi_UInt16_t;
typedef int blpapi_Int32_t;
typedef unsigned int blpapi_UInt32_t;
typedef long long blpapi_Int64_t;
typedef unsigned long long blpapi_UInt64_t;
typedef float blpapi_Float32_t;
typedef double blpapi_Float64_t;

enum blpapi_DataType_t {
    BLPAPI_DATATYPE_BOOL = 1 
    ,
    BLPAPI_DATATYPE_CHAR = 2 
    ,
    BLPAPI_DATATYPE_BYTE = 3 
    ,
    BLPAPI_DATATYPE_INT32 = 4 
    ,
    BLPAPI_DATATYPE_INT64 = 5 
    ,
    BLPAPI_DATATYPE_FLOAT32 = 6 
    ,
    BLPAPI_DATATYPE_FLOAT64 = 7 
    ,
    BLPAPI_DATATYPE_STRING = 8 
    ,
    BLPAPI_DATATYPE_BYTEARRAY = 9 
    ,
    BLPAPI_DATATYPE_DATE = 10 
    ,
    BLPAPI_DATATYPE_TIME = 11 
    ,
    BLPAPI_DATATYPE_DECIMAL = 12 
    ,
    BLPAPI_DATATYPE_DATETIME = 13 
    ,
    BLPAPI_DATATYPE_ENUMERATION = 14 
    ,
    BLPAPI_DATATYPE_SEQUENCE = 15 
    ,
    BLPAPI_DATATYPE_CHOICE = 16 
    ,
    BLPAPI_DATATYPE_CORRELATION_ID = 17 
};

typedef enum blpapi_Logging_Severity_t {
    blpapi_Logging_SEVERITY_OFF = 0,
    blpapi_Logging_SEVERITY_FATAL = 1,
    blpapi_Logging_SEVERITY_ERROR = 2,
    blpapi_Logging_SEVERITY_WARN = 3,
    blpapi_Logging_SEVERITY_INFO = 4,
    blpapi_Logging_SEVERITY_DEBUG = 5,
    blpapi_Logging_SEVERITY_TRACE = 6
} blpapi_Logging_Severity_t;

struct blpapi_AbstractSession;
typedef struct blpapi_AbstractSession blpapi_AbstractSession_t;

struct blpapi_Constant;
typedef struct blpapi_Constant blpapi_Constant_t;

struct blpapi_ConstantList;
typedef struct blpapi_ConstantList blpapi_ConstantList_t;

struct blpapi_Element;
typedef struct blpapi_Element blpapi_Element_t;

struct blpapi_Event;
typedef struct blpapi_Event blpapi_Event_t;

struct blpapi_EventDispatcher;
typedef struct blpapi_EventDispatcher blpapi_EventDispatcher_t;

struct blpapi_EventFormatter;
typedef struct blpapi_EventFormatter blpapi_EventFormatter_t;

struct blpapi_EventQueue;
typedef struct blpapi_EventQueue blpapi_EventQueue_t;

struct blpapi_MessageIterator;
typedef struct blpapi_MessageIterator blpapi_MessageIterator_t;

struct blpapi_Name;
typedef struct blpapi_Name blpapi_Name_t;

struct blpapi_Operation;
typedef struct blpapi_Operation blpapi_Operation_t;

struct blpapi_ProviderSession;
typedef struct blpapi_ProviderSession blpapi_ProviderSession_t;

struct blpapi_RequestTemplate;
typedef struct blpapi_RequestTemplate blpapi_RequestTemplate_t;

struct blpapi_Service;
typedef struct blpapi_Service blpapi_Service_t;

struct blpapi_Session;
typedef struct blpapi_Session blpapi_Session_t;

struct blpapi_SessionOptions;
typedef struct blpapi_SessionOptions blpapi_SessionOptions_t;

struct blpapi_Socks5Config;
typedef struct blpapi_Socks5Config blpapi_Socks5Config_t;

struct blpapi_TlsOptions;
typedef struct blpapi_TlsOptions blpapi_TlsOptions_t;

struct blpapi_SubscriptionItrerator;
typedef struct blpapi_SubscriptionItrerator blpapi_SubscriptionIterator_t;

struct blpapi_Identity;
typedef struct blpapi_Identity blpapi_UserHandle;
typedef struct blpapi_Identity blpapi_UserHandle_t;

struct blpapi_Identity;
typedef struct blpapi_Identity blpapi_Identity_t;

struct blpapi_SchemaElementDefinition;
typedef struct blpapi_SchemaElementDefinition blpapi_SchemaElementDefinition_t;

struct blpapi_Datetime_tag;
typedef struct blpapi_Datetime_tag blpapi_Datetime_t;

struct blpapi_MessageFormatter;
typedef struct blpapi_MessageFormatter blpapi_MessageFormatter_t;

struct blpapi_MessageProperties;
typedef struct blpapi_MessageProperties blpapi_MessageProperties_t;

struct blpapi_AuthOptions;
typedef struct blpapi_AuthOptions blpapi_AuthOptions_t;

struct blpapi_AuthUser;
typedef struct blpapi_AuthUser blpapi_AuthUser_t;

struct blpapi_AuthApplication;
typedef struct blpapi_AuthApplication blpapi_AuthApplication_t;

struct blpapi_AuthToken;
typedef struct blpapi_AuthToken blpapi_AuthToken_t;

#ifdef __cplusplus

#include <cassert>
#include <cstddef>
#include <iterator>
#include <type_traits>
#include <utility>

namespace BloombergLP {
namespace blpapi {

struct DataType {

  public:
    enum Value {
        BOOL = BLPAPI_DATATYPE_BOOL, 
        CHAR = BLPAPI_DATATYPE_CHAR, 
        BYTE = BLPAPI_DATATYPE_BYTE, 
        INT32 = BLPAPI_DATATYPE_INT32, 
        INT64 = BLPAPI_DATATYPE_INT64, 
        FLOAT32 = BLPAPI_DATATYPE_FLOAT32, 
        FLOAT64 = BLPAPI_DATATYPE_FLOAT64, 
        STRING = BLPAPI_DATATYPE_STRING, 
        BYTEARRAY = BLPAPI_DATATYPE_BYTEARRAY, 
        DATE = BLPAPI_DATATYPE_DATE, 
        TIME = BLPAPI_DATATYPE_TIME, 
        DECIMAL = BLPAPI_DATATYPE_DECIMAL, 
        DATETIME = BLPAPI_DATATYPE_DATETIME, 
        ENUMERATION = BLPAPI_DATATYPE_ENUMERATION, 
        SEQUENCE = BLPAPI_DATATYPE_SEQUENCE, 
        CHOICE = BLPAPI_DATATYPE_CHOICE, 
        CORRELATION_ID = BLPAPI_DATATYPE_CORRELATION_ID 
    };
};

#ifndef DOXYGEN_SHOULD_SKIP_THIS

template <typename T, typename U = bool> struct IsString : std::false_type { };

template <typename T>
struct IsString<T,
        typename std::enable_if<
                std::is_member_function_pointer<decltype(&T::c_str)>::value,
                bool>::type> : std::true_type { };

template <typename T, typename U = bool>
struct IsByteSequence : std::false_type { };

template <typename T>
struct IsByteSequence<T,
        typename std::enable_if<
                std::is_member_function_pointer<
                        decltype(static_cast<const typename T::value_type *(
                                        T::*)() const>(&T::data))>::value
                        && sizeof(typename T::value_type) == 1
                        && !IsString<T>::value,
                bool>::type> : std::true_type { };

template <typename T, typename ITER, typename U = bool>
struct IsByteContainer : std::false_type { };

template <typename T, typename ITER>
struct IsByteContainer<T,
        ITER,
        typename std::enable_if<std::is_constructible<T, ITER, ITER>::value
                        && sizeof(typename T::value_type) == 1,
                bool>::type> : std::true_type { };

#endif // ifndef DOXYGEN_SHOULD_SKIP_THIS

class Bytes {

  public:
    typedef const char element_type;
    typedef char value_type;
    typedef std::size_t size_type;
    typedef std::ptrdiff_t difference_type;
    typedef const char *pointer;
    typedef const char *const_pointer;
    typedef const char& reference;
    typedef const char& const_reference;
    typedef const char *iterator;
    typedef const char *const_iterator;
    typedef std::reverse_iterator<iterator> reverse_iterator;
    typedef std::reverse_iterator<const_iterator> const_reverse_iterator;

  private:
    const value_type *d_ptr;
    size_type d_length;

  public:
    Bytes() noexcept;
    Bytes(pointer ptr, size_type length) noexcept;
    void assign(pointer ptr, size_type length) noexcept;
    iterator begin() const noexcept;
    iterator end() const noexcept;
    reverse_iterator rbegin() const noexcept;
    reverse_iterator rend() const noexcept;
    reference front() const;
    reference back() const;
    reference operator[](size_type index) const;
    pointer data() const noexcept;
    size_type size() const noexcept;
    bool empty() const noexcept;
    Bytes first(size_type count) const;
    Bytes last(size_type count) const;
    Bytes subspan(size_type offset,
            size_type count = static_cast<std::size_t>(-1)) const;
    template <typename BYTE_CONTAINER,
            typename std::enable_if<
                    IsByteContainer<BYTE_CONTAINER, iterator>::value,
                    bool>::type
            = true>
    operator BYTE_CONTAINER() const;
};

typedef blpapi_Bool_t Bool;
typedef blpapi_Char_t Char;
typedef blpapi_UChar_t UChar;
typedef blpapi_Int16_t Int16;
typedef blpapi_UInt16_t UInt16;
typedef blpapi_Int32_t Int32;
typedef blpapi_UInt32_t UInt32;
typedef blpapi_Int64_t Int64;
typedef blpapi_UInt64_t UInt64;
typedef blpapi_Float32_t Float32;
typedef blpapi_Float64_t Float64;

//=============================================================================
//                           INLINE FUNCTION DEFINITIONS
//=============================================================================

// -----------
// class Bytes
// -----------

inline Bytes::Bytes() noexcept
    : d_ptr(nullptr)
    , d_length(0)
{
}

inline Bytes::Bytes(pointer ptr, size_type length) noexcept
    : d_ptr(ptr)
    , d_length(length)
{
}

inline void Bytes::assign(pointer ptr, size_type length) noexcept
{
    d_ptr = ptr;
    d_length = length;
}

inline Bytes::iterator Bytes::begin() const noexcept { return d_ptr; }

inline Bytes::iterator Bytes::end() const noexcept { return d_ptr + d_length; }

inline Bytes::reverse_iterator Bytes::rbegin() const noexcept
{
    return reverse_iterator(end());
}

inline Bytes::reverse_iterator Bytes::rend() const noexcept
{
    return reverse_iterator(begin());
}

inline Bytes::reference Bytes::front() const
{
    assert(d_ptr);
    assert(d_length);
    return d_ptr[0];
}

inline Bytes::reference Bytes::back() const
{
    assert(d_ptr);
    assert(d_length);
    return d_ptr[d_length - 1];
}

inline Bytes::reference Bytes::operator[](size_type index) const
{
    assert(d_ptr);
    assert(index < d_length);
    return d_ptr[index];
}

inline Bytes::pointer Bytes::data() const noexcept { return d_ptr; }

inline Bytes::size_type Bytes::size() const noexcept { return d_length; }

inline bool Bytes::empty() const noexcept { return 0 == d_length; }

inline Bytes Bytes::first(size_type count) const
{
    assert(count <= d_length);
    return Bytes(d_ptr, count);
}

inline Bytes Bytes::last(size_type count) const
{
    assert(count <= d_length);
    return Bytes(d_ptr + d_length - count, count);
}

inline Bytes Bytes::subspan(size_type offset, size_type count) const
{
    assert(offset <= d_length);
    assert(count == static_cast<std::size_t>(-1)
            || count <= d_length - offset);
    return Bytes(d_ptr + offset,
            count == static_cast<std::size_t>(-1) ? d_length - offset : count);
}

template <typename BYTE_CONTAINER,
        typename std::enable_if<
                IsByteContainer<BYTE_CONTAINER, Bytes::iterator>::value,
                bool>::type>
inline Bytes::operator BYTE_CONTAINER() const
{
    assert(d_ptr || d_length == 0);
    return BYTE_CONTAINER(begin(), end());
}

} // close namespace blpapi
} // close namespace BloombergLP

#endif // ifdef __cplusplus

#endif // #ifndef INCLUDED_BLPAPI_TYPES