rtosc.h

Go to the documentation of this file.

/*
 * Copyright (c) 2012 Mark McCurry
 *
 * 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 (including the next
 * paragraph) 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.
 *
 * @file rtosc.h
 */
#ifndef RTOSC_H
#define RTOSC_H
#include <stdarg.h>
#include <stdint.h>
#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
    int32_t len;  //< length of blob's data section in bytes
    uint8_t *data;//< pointer to blob's data section
} rtosc_blob_t;

typedef union {
    int32_t       i;   //< i,c,r types
    char          T;   //< I,T,F,N types
    float         f;   //< f type
    double        d;   //< d type
    int64_t       h;   //< h type
    uint64_t      t;   //< t type
    uint8_t       m[4];//< m type
    const char   *s;   //< s,S types
    rtosc_blob_t  b;   //< b type
} rtosc_arg_t;

size_t rtosc_message(char   *buffer,
        size_t      len,
        const char *address,
        const char *arguments,
        ...);

size_t rtosc_vmessage(char   *buffer,
        size_t      len,
        const char *address,
        const char *arguments,
        va_list va);

size_t rtosc_amessage(char        *buffer,
                      size_t       len,
                      const char  *address,
                      const char  *arguments,
                      const rtosc_arg_t *args);

unsigned rtosc_narguments(const char *msg);

char rtosc_type(const char *msg, unsigned i);

rtosc_arg_t rtosc_argument(const char *msg, unsigned i);

size_t rtosc_message_length(const char *msg, size_t len);

typedef struct {
    char *data;
    size_t len;
} ring_t;

size_t rtosc_message_ring_length(ring_t *ring);

const char *rtosc_argument_string(const char *msg);

size_t rtosc_bundle(char *buffer, size_t len, uint64_t tt, int elms, ...);

size_t rtosc_bundle_elements(const char *msg, size_t len);

const char *rtosc_bundle_fetch(const char *msg, unsigned i);

int rtosc_bundle_p(const char *msg);

uint64_t rtosc_bundle_timetag(const char *msg);

#ifdef __cplusplus
};
#endif
#endif