Main Content

category

Field category search for Bloomberg Server connection V3

Since R2021a

Description

example

d = category(c,f) returns category information given the search term f using the Bloomberg® Server C++ interface.

Examples

collapse all

Create a Bloomberg connection, and then request the category description of the last price field.

Connect to the Bloomberg Server using the IP address of the machine running the Bloomberg Server. This example uses the Bloomberg Server C++ interface and assumes the following:

  • The Bloomberg UUID is 12345678.

  • The IP address for the machine running the Bloomberg Server is '111.11.11.111'.

c is a bloombergServer object.

uuid = 12345678;
ipaddress = '111.11.11.111';

c = bloombergServer(uuid,ipaddress);

Return data as a table by setting the DataReturnFormat property of the bloomberg object. If you do not set this property, the category function returns data as a cell array.

c.DataReturnFormat = 'table';

Request the Bloomberg category description of the last price field.

f = 'LAST_PRICE';
d = category(c,f);

Display the first three rows of the Bloomberg category description data in d.

d(1:3,:)
ans =

  3×5 table

     CATEGORY       ID                   MNEMONIC                          DESCRIPTION               DATATYPE
    __________    _______    ________________________________    ________________________________    ________

    'Analysis'    'OP179'    'THETA_LAST'                        'Theta Last Price'                  'Double'
    'Analysis'    'VM048'    'DDMX_PERCENT_CHANGE_LAST_PRICE'    'DDMX Percent Change Last Price'    'Double'
    'Analysis'    'YL005'    'YLD_CNV_LAST'                      'Last Yield To Convention'          'Double'

The columns in d are:

  • Category

  • Field identifier

  • Field mnemonic

  • Field name

  • Field data type

Close the Bloomberg connection.

close(c)

Input Arguments

collapse all

Bloomberg Server connection, specified as a bloombergServer object.

Search term, specified as a character vector or string scalar to denote Bloomberg fields.

Data Types: char | string

Output Arguments

collapse all

Category data, returned as an N-by-5 cell array, a structure, or a table.

The columns (or fields) of the data types are:

  • Category

  • Field identifier

  • Field mnemonic

  • Field name

  • Field data type

The data type of the category data depends on the DataReturnFormat property of the connection object.

Version History

Introduced in R2021a