aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/cubeb_strings.h
blob: cfffbbc68aca4ac87e480b71f3de08f68a094928 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
/*
 * Copyright © 2011 Mozilla Foundation
 *
 * This program is made available under an ISC-style license.  See the
 * accompanying file LICENSE for details.
 */

#ifndef CUBEB_STRINGS_H
#define CUBEB_STRINGS_H

#include "cubeb/cubeb.h"

#if defined(__cplusplus)
extern "C" {
#endif

/** Opaque handle referencing interned string storage. */
typedef struct cubeb_strings cubeb_strings;

/** Initialize an interned string structure.
    @param strings An out param where an opaque pointer to the
    interned string storage will be returned.
    @retval CUBEB_OK in case of success.
    @retval CUBEB_ERROR in case of error. */
CUBEB_EXPORT int
cubeb_strings_init(cubeb_strings ** strings);

/** Destroy an interned string structure freeing all associated memory.
    @param strings An opaque pointer to the interned string storage to
                   destroy. */
CUBEB_EXPORT void
cubeb_strings_destroy(cubeb_strings * strings);

/** Add string to internal storage.
    @param strings Opaque pointer to interned string storage.
    @param s String to add to storage.
    @retval CUBEB_OK
    @retval CUBEB_ERROR
 */
CUBEB_EXPORT char const *
cubeb_strings_intern(cubeb_strings * strings, char const * s);

#if defined(__cplusplus)
}
#endif

#endif // !CUBEB_STRINGS_H