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;
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; 
 
namespace util {

 
constexpr const char *to_string(DataType::Value type);

 
} // close namespace util
 
//=============================================================================
//                           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());
}
 
// --------------
// namespace util
// --------------
constexpr const char *util::to_string(DataType::Value type)
{
    switch (type) {
    case DataType::BOOL:
        return "BOOL";
    case DataType::CHAR:
        return "CHAR";
    case DataType::BYTE:
        return "BYTE";
    case DataType::INT32:
        return "INT32";
    case DataType::INT64:
        return "INT64";
    case DataType::FLOAT32:
        return "FLOAT32";
    case DataType::FLOAT64:
        return "FLOAT64";
    case DataType::STRING:
        return "STRING";
    case DataType::BYTEARRAY:
        return "BYTEARRAY";
    case DataType::DATE:
        return "DATE";
    case DataType::TIME:
        return "TIME";
    case DataType::DECIMAL:
        return "DECIMAL";
    case DataType::DATETIME:
        return "DATETIME";
    case DataType::ENUMERATION:
        return "ENUMERATION";
    case DataType::SEQUENCE:
        return "SEQUENCE";
    case DataType::CHOICE:
        return "CHOICE";
    case DataType::CORRELATION_ID:
        return "CORRELATION_ID";
    }
    // Silence warnings on some compilers
    return "UNDEFINED";
}
 
} // close namespace blpapi
} // close namespace BloombergLP
 
#endif // ifdef __cplusplus
 
#endif // #ifndef INCLUDED_BLPAPI_TYPES