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.
 */

 
#ifndef RTOSC_H
#define RTOSC_H
#include <stdarg.h>
#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct {
    int32_t len;
    uint8_t *data;
} rtosc_blob_t;
 
typedef union {
    int32_t       i;   //i,c,r
    char          T;   //I,T,F,N
    float         f;   //f
    double        d;   //d
    int64_t       h;   //h
    uint64_t      t;   //t
    uint8_t       m[4];//m
    const char   *s;   //s,S
    rtosc_blob_t  b;   //b
} 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);
 
typedef struct {
    const char    *type_pos;
    const uint8_t *value_pos;
} rtosc_arg_itr_t;
 
typedef struct {
    char type;
    rtosc_arg_t val;
} rtosc_arg_val_t;
 
typedef struct
{
    double float_tolerance;
} rtosc_cmp_options;

int rtosc_arg_vals_eq(rtosc_arg_val_t* lhs, rtosc_arg_val_t* rhs,
                      size_t lsize, size_t rsize,
                      const rtosc_cmp_options* opt);

int rtosc_arg_vals_cmp(rtosc_arg_val_t* lhs, rtosc_arg_val_t* rhs,
                       size_t lsize, size_t rsize,
                       const rtosc_cmp_options* opt);

typedef struct { va_list a; } rtosc_va_list_t;

void rtosc_v2args(rtosc_arg_t* args, size_t nargs,
                  const char* arg_str, rtosc_va_list_t* ap);

void rtosc_v2argvals(rtosc_arg_val_t* args, size_t nargs,
                     const char* arg_str, va_list ap);

void rtosc_2argvals(rtosc_arg_val_t* args, size_t nargs,
                    const char* arg_str, ...);

rtosc_arg_itr_t rtosc_itr_begin(const char *msg);

rtosc_arg_val_t rtosc_itr_next(rtosc_arg_itr_t *itr);

int rtosc_itr_end(rtosc_arg_itr_t itr);

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);
 

bool rtosc_valid_message_p(const char *msg, size_t len);

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);

size_t rtosc_bundle_size(const char *msg, unsigned i);

int rtosc_bundle_p(const char *msg);

uint64_t rtosc_bundle_timetag(const char *msg);
 

bool rtosc_match(const char *pattern,
                 const char *msg, const char** path_end);
 

const char *rtosc_match_path(const char *pattern,
                             const char *msg, const char** path_end);
 
#ifdef __cplusplus
};
#endif
#endif