wxdragon-sys 0.9.16

Raw FFI bindings to libwxdragon (which statically links wxWidgets).
Documentation 
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

#include <wx/wxprec.h>
#include <wx/wx.h>
#include "../include/wxdragon.h"
#include <wx/arrstr.h>

// ArrayString helper functions
WXD_EXPORTED wxd_ArrayString_t*
wxd_ArrayString_Create()
{
    return reinterpret_cast<wxd_ArrayString_t*>(new (std::nothrow) wxArrayString());
}

WXD_EXPORTED void
wxd_ArrayString_Free(wxd_ArrayString_t* self)
{
    if (self) {
        delete reinterpret_cast<wxArrayString*>(self);
    }
}

WXD_EXPORTED wxd_ArrayString_t*
wxd_ArrayString_Clone(const wxd_ArrayString_t* array)
{
    if (!array)
        return nullptr;
    const wxArrayString* wx_array = reinterpret_cast<const wxArrayString*>(array);
    wxArrayString* cloned = new (std::nothrow) wxArrayString(*wx_array);
    if (!cloned)
        return nullptr;
    return reinterpret_cast<wxd_ArrayString_t*>(cloned);
}

WXD_EXPORTED int
wxd_ArrayString_GetCount(const wxd_ArrayString_t* array)
{
    if (!array)
        return 0;
    const wxArrayString* wx_array = reinterpret_cast<const wxArrayString*>(array);
    return wx_array->GetCount();
}

/**
 * Get string at specified index.
 * Returns the real length of the string, excluding the null terminator.
 * If the returned length is negative, indicates an error (invalid index or parameters).
 * If buffer is non-null and bufferLen > 0, copies up to bufferLen - 1 characters and null-terminates.
 * If buffer is null or bufferLen == 0, does not copy anything.
 */
WXD_EXPORTED int
wxd_ArrayString_GetString(const wxd_ArrayString_t* array, int index, char* buffer, size_t bufferLen)
{
    if (!array)
        return -1;

    const wxArrayString* wx_array = reinterpret_cast<const wxArrayString*>(array);
    if (index < 0 || index >= static_cast<int>(wx_array->GetCount()))
        return -1;

    wxString str = wx_array->Item(index);
    return (int)wxd_cpp_utils::copy_wxstring_to_buffer(str, buffer, bufferLen);
}

WXD_EXPORTED bool
wxd_ArrayString_Add(wxd_ArrayString_t* self, const char* str)
{
    if (!self)
        return false;
    wxArrayString* wx_arr_str = reinterpret_cast<wxArrayString*>(self);
    wx_arr_str->Add(WXD_STR_TO_WX_STRING_UTF8_NULL_OK(str));
    return true;
}

WXD_EXPORTED void
wxd_ArrayString_Clear(wxd_ArrayString_t* self)
{
    if (!self)
        return;
    wxArrayString* wx_arr_str = reinterpret_cast<wxArrayString*>(self);
    wx_arr_str->Clear();
}

// Helper function to populate a wxd_ArrayString_t from a wxArrayString
// Exported for use by other components like file_dialog.cpp
WXD_EXPORTED void
wxd_ArrayString_AssignFromWxArrayString(wxd_ArrayString_t* target, const wxArrayString& source)
{
    if (!target)
        return;
    wxArrayString* dest_wx_arr = reinterpret_cast<wxArrayString*>(target);
    *dest_wx_arr = source; // wxArrayString has an assignment operator
}