doubango-android/tinySDP/include/tinysdp/headers/tsdp_header_T.h

/*
* Copyright (C) 2010-2011 Mamadou Diop.
*
* Contact: Mamadou Diop <diopmamadou(at)doubango[dot]org>
*
* This file is part of Open Source Doubango Framework.
*
* DOUBANGO is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* DOUBANGO is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with DOUBANGO.
*
*/

/**@file tsdp_header_T.h
 * @brief SDP "t=" header (Timing).
 *
 * @author Mamadou Diop <diopmamadou(at)doubango[dot]org>
 *
 *
 */
#ifndef _TSDP_HEADER_T_H_
#define _TSDP_HEADER_T_H_

#include "tinysdp_config.h"
#include "tinysdp/headers/tsdp_header.h"

#include "tinysdp/headers/tsdp_header_R.h"

TSDP_BEGIN_DECLS

#define TSDP_HEADER_T_VA_ARGS(start, stop)		tsdp_header_T_def_t, (uint64_t)start, (uint64_t)stop

////////////////////////////////////////////////////////////////////////////////////////////////////
/// @struct
///
/// @brief	SDP "t=" header (Timing).
/// The "t=" lines specify the start and stop times for a session.
///   Multiple "t=" lines MAY be used if a session is active at multiple
///   irregularly spaced times; each additional "t=" line specifies an
///   additional period of time for which the session will be active.  If
///   the session is active at regular times, an "r=" line (see below)
///   should be used in addition to, and following, a "t=" line -- in which
///   case the "t=" line specifies the start and stop times of the repeat
///   sequence.
///
///
/// @par ABNF : t= 	 start-time SP stop-time *( CRLF repeat-fields )
///
////////////////////////////////////////////////////////////////////////////////////////////////////
typedef struct tsdp_header_T_s {
    TSDP_DECLARE_HEADER;
    uint64_t start;
    uint64_t stop;

    tsdp_headers_R_L_t* repeat_fields;
}
tsdp_header_T_t;

typedef tsk_list_t tsdp_headers_T_L_t;

TINYSDP_API tsdp_header_T_t* tsdp_header_T_create(uint64_t start, uint64_t stop);
TINYSDP_API tsdp_header_T_t* tsdp_header_T_create_null();

TINYSDP_API tsdp_header_T_t *tsdp_header_T_parse(const char *data, tsk_size_t size);

TINYSDP_GEXTERN const tsk_object_def_t *tsdp_header_T_def_t;

TSDP_END_DECLS

#endif /* _TSDP_HEADER_P_H_ */