Custom C++ Simple Function Sample

Contents

Importing This Sample into StreamBase Studio
Installed Sample File Locations
Running the Custom C++ Simple Function Sample

The log.sbapp application demonstrates how to use a custom C++ simple function.

This topic describes how to load and run the sample. For detailed information about the sample, see the topic, Creating Custom C++ Functions, in the API Guide.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top menu, click File → Load StreamBase Sample.

  • Select this sample from the Extending StreamBase list.

  • Click OK.

StreamBase Studio creates a project for the sample.

Installed Sample File Locations

By default, the sample files are installed in:

  • On Windows: C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\custom-simple-function

  • On UNIX: /opt/streambase/sample/custom-simple-function

The sample has the following files:

  • A sample configuration file, sbd.sbconf, which tells the StreamBase Server to load the custom simple function.

  • A sample application, log.sbapp, which uses the function.

  • Dynamically linked library for the custom simple function.

  • The source code for the custom simple function, LogFunction.cpp

  • Either Microsoft Visual Studio .Net solution and project files (Windows) or a Makefile (UNIX) that can be used to (re)build all of the sample source code. (In the Visual Studio files, the paths to find StreamBase include files and libraries are configured to run from the installation directory.)

Running the Custom C++ Simple Function Sample

To run this sample:

Running custom-simple-function in StreamBase Studio

  1. In the Package Explorer, double-click to open the log.sbapp application. Make sure the application is the currently active tab in the EventFlow Editor.

  2. Click the Run StreamBase Application (Default Launch) button. (Not the Run button.) This opens the Test/Debug perspective and starts the application.

  3. In the Application Output view, select the output stream.

  4. In the Manual Input view, select the input stream.

  5. Enter 1.

  6. Click Send Data, and observe 0.0 appears in the output stream.

  7. Enter 10.

  8. Click Send Data, and observe 2.302585092994046 appears in the output stream.

  9. Using the same send technique, send 50 and 100, and observe 3.912023005428146 and 4.605170185988092 appears respectively in the output stream.

  10. Click Run → Stop Running Application.

Running the custom-simple-function sample in Terminal Windows

To run this sample:

  1. Launch a StreamBase Server on the sample application:

    sbd -f sbd.sbconf log.sbapp

  2. Run a dequeuer so that you can see the output that will be produced:

    sbc dequeue output

  3. Run an enqueuer:

    sbc enqueue input

  4. Type numbers into the enqueuer, one number per line. For example, if you enter the numbers 1, 10, 50, and 100, then you should see the following output from the dequeuer:

    0
    2.30258509299405
    3.91202300542815
    4.60517018598809

  5. To see what happens when the function throws an exception, try enqueueing a negative number.

Back to Top ^