| David Tolnay | d41eef5 | 2020-10-07 16:33:55 -0700 | [diff] [blame] | 1 | #include "tests/ffi/tests.h" |
| 2 | #include "tests/ffi/lib.rs.h" |
| David Tolnay | b6c5ea7 | 2020-03-16 13:36:28 -0700 | [diff] [blame] | 3 | #include <cstring> |
| David Tolnay | a08b19f | 2020-08-25 19:21:14 -0700 | [diff] [blame] | 4 | #include <iterator> |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 5 | #include <memory> |
| David Tolnay | 37dd7e1 | 2020-04-25 12:51:59 -0700 | [diff] [blame] | 6 | #include <numeric> |
| David Tolnay | ebef4a2 | 2020-03-17 15:33:47 -0700 | [diff] [blame] | 7 | #include <stdexcept> |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 8 | #include <string> |
| David Tolnay | 97c7210 | 2020-01-25 16:49:00 -0800 | [diff] [blame] | 9 | |
| David Tolnay | 2fe58c6 | 2020-03-06 16:23:09 -0800 | [diff] [blame] | 10 | extern "C" void cxx_test_suite_set_correct() noexcept; |
| 11 | extern "C" tests::R *cxx_test_suite_get_box() noexcept; |
| 12 | extern "C" bool cxx_test_suite_r_is_correct(const tests::R *) noexcept; |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 13 | |
| David Tolnay | 97c7210 | 2020-01-25 16:49:00 -0800 | [diff] [blame] | 14 | namespace tests { |
| 15 | |
| David Tolnay | 4037de2 | 2020-04-30 19:51:04 -0700 | [diff] [blame] | 16 | static constexpr char SLICE_DATA[] = "2020"; |
| Adrian Taylor | f5dd552 | 2020-04-13 16:50:14 -0700 | [diff] [blame] | 17 | |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 18 | C::C(size_t n) : n(n) {} |
| 19 | |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 20 | size_t C::get() const { return this->n; } |
| 21 | |
| Joel Galenson | e1e969d | 2020-04-21 12:50:20 -0700 | [diff] [blame] | 22 | size_t C::get2() const { return this->n; } |
| 23 | |
| Joel Galenson | 3d4f612 | 2020-04-07 15:54:05 -0700 | [diff] [blame] | 24 | size_t C::set(size_t n) { |
| 25 | this->n = n; |
| 26 | return this->n; |
| 27 | } |
| 28 | |
| Joel Galenson | e1e969d | 2020-04-21 12:50:20 -0700 | [diff] [blame] | 29 | size_t C::set2(size_t n) { |
| 30 | this->n = n; |
| 31 | return this->n; |
| 32 | } |
| 33 | |
| myronahn | e3b78ea | 2020-05-23 01:08:13 +0700 | [diff] [blame] | 34 | size_t C::set_succeed(size_t n) { return this->set2(n); } |
| 35 | |
| 36 | size_t C::get_fail() { throw std::runtime_error("unimplemented"); } |
| 37 | |
| David Tolnay | de5340e | 2020-04-25 14:03:21 -0700 | [diff] [blame] | 38 | const std::vector<uint8_t> &C::get_v() const { return this->v; } |
| 39 | |
| David Tolnay | 18d93b6 | 2020-08-27 00:55:48 -0700 | [diff] [blame] | 40 | std::vector<uint8_t> &C::get_v() { return this->v; } |
| 41 | |
| David Tolnay | b871577 | 2020-01-28 00:54:05 -0800 | [diff] [blame] | 42 | size_t c_return_primitive() { return 2020; } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 43 | |
| David Tolnay | b871577 | 2020-01-28 00:54:05 -0800 | [diff] [blame] | 44 | Shared c_return_shared() { return Shared{2020}; } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 45 | |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 46 | ::A::AShared c_return_ns_shared() { return ::A::AShared{2020}; } |
| 47 | |
| 48 | ::A::B::ABShared c_return_nested_ns_shared() { return ::A::B::ABShared{2020}; } |
| 49 | |
| David Tolnay | be13d8a | 2020-03-06 15:45:39 -0800 | [diff] [blame] | 50 | rust::Box<R> c_return_box() { |
| 51 | return rust::Box<R>::from_raw(cxx_test_suite_get_box()); |
| 52 | } |
| 53 | |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 54 | std::unique_ptr<C> c_return_unique_ptr() { |
| 55 | return std::unique_ptr<C>(new C{2020}); |
| 56 | } |
| 57 | |
| Adrian Taylor | d47af7a | 2020-10-26 13:18:48 -0700 | [diff] [blame] | 58 | std::unique_ptr<::H::H> c_return_ns_unique_ptr() { |
| 59 | return std::unique_ptr<::H::H>(new ::H::H{"hello"}); |
| 60 | } |
| 61 | |
| David Tolnay | b871577 | 2020-01-28 00:54:05 -0800 | [diff] [blame] | 62 | const size_t &c_return_ref(const Shared &shared) { return shared.z; } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 63 | |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 64 | const size_t &c_return_ns_ref(const ::A::AShared &shared) { return shared.z; } |
| 65 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 66 | const size_t &c_return_nested_ns_ref(const ::A::B::ABShared &shared) { |
| 67 | return shared.z; |
| 68 | } |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 69 | |
| David Tolnay | 18d93b6 | 2020-08-27 00:55:48 -0700 | [diff] [blame] | 70 | size_t &c_return_mut(Shared &shared) { return shared.z; } |
| 71 | |
| David Tolnay | 750755e | 2020-03-01 13:04:08 -0800 | [diff] [blame] | 72 | rust::Str c_return_str(const Shared &shared) { |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 73 | (void)shared; |
| 74 | return "2020"; |
| 75 | } |
| 76 | |
| David Tolnay | eb952ba | 2020-04-14 15:02:24 -0700 | [diff] [blame] | 77 | rust::Slice<uint8_t> c_return_sliceu8(const Shared &shared) { |
| Adrian Taylor | f5dd552 | 2020-04-13 16:50:14 -0700 | [diff] [blame] | 78 | (void)shared; |
| David Tolnay | 4037de2 | 2020-04-30 19:51:04 -0700 | [diff] [blame] | 79 | return rust::Slice<uint8_t>(reinterpret_cast<const uint8_t *>(SLICE_DATA), |
| 80 | sizeof(SLICE_DATA)); |
| Adrian Taylor | f5dd552 | 2020-04-13 16:50:14 -0700 | [diff] [blame] | 81 | } |
| 82 | |
| David Tolnay | 750755e | 2020-03-01 13:04:08 -0800 | [diff] [blame] | 83 | rust::String c_return_rust_string() { return "2020"; } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 84 | |
| 85 | std::unique_ptr<std::string> c_return_unique_ptr_string() { |
| 86 | return std::unique_ptr<std::string>(new std::string("2020")); |
| 87 | } |
| 88 | |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 89 | std::unique_ptr<std::vector<uint8_t>> c_return_unique_ptr_vector_u8() { |
| David Tolnay | 85db5a0 | 2020-04-25 13:17:27 -0700 | [diff] [blame] | 90 | auto vec = std::unique_ptr<std::vector<uint8_t>>(new std::vector<uint8_t>()); |
| 91 | vec->push_back(86); |
| 92 | vec->push_back(75); |
| 93 | vec->push_back(30); |
| 94 | vec->push_back(9); |
| 95 | return vec; |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 96 | } |
| 97 | |
| 98 | std::unique_ptr<std::vector<double>> c_return_unique_ptr_vector_f64() { |
| David Tolnay | 85db5a0 | 2020-04-25 13:17:27 -0700 | [diff] [blame] | 99 | auto vec = std::unique_ptr<std::vector<double>>(new std::vector<double>()); |
| 100 | vec->push_back(86.0); |
| 101 | vec->push_back(75.0); |
| 102 | vec->push_back(30.0); |
| 103 | vec->push_back(9.5); |
| 104 | return vec; |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 105 | } |
| 106 | |
| David Tolnay | 47e239d | 2020-08-28 00:32:04 -0700 | [diff] [blame] | 107 | std::unique_ptr<std::vector<std::string>> c_return_unique_ptr_vector_string() { |
| 108 | return std::unique_ptr<std::vector<std::string>>( |
| 109 | new std::vector<std::string>()); |
| 110 | } |
| 111 | |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 112 | std::unique_ptr<std::vector<Shared>> c_return_unique_ptr_vector_shared() { |
| David Tolnay | 85db5a0 | 2020-04-25 13:17:27 -0700 | [diff] [blame] | 113 | auto vec = std::unique_ptr<std::vector<Shared>>(new std::vector<Shared>()); |
| 114 | vec->push_back(Shared{1010}); |
| 115 | vec->push_back(Shared{1011}); |
| 116 | return vec; |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 117 | } |
| 118 | |
| David Tolnay | 1bcc9fe | 2020-04-25 13:51:07 -0700 | [diff] [blame] | 119 | std::unique_ptr<std::vector<C>> c_return_unique_ptr_vector_opaque() { |
| 120 | return std::unique_ptr<std::vector<C>>(new std::vector<C>()); |
| 121 | } |
| 122 | |
| David Tolnay | de5340e | 2020-04-25 14:03:21 -0700 | [diff] [blame] | 123 | const std::vector<uint8_t> &c_return_ref_vector(const C &c) { |
| 124 | return c.get_v(); |
| 125 | } |
| 126 | |
| David Tolnay | 18d93b6 | 2020-08-27 00:55:48 -0700 | [diff] [blame] | 127 | std::vector<uint8_t> &c_return_mut_vector(C &c) { return c.get_v(); } |
| 128 | |
| David Tolnay | b41e74c | 2020-04-25 15:06:18 -0700 | [diff] [blame] | 129 | rust::Vec<uint8_t> c_return_rust_vec() { |
| 130 | throw std::runtime_error("unimplemented"); |
| 131 | } |
| 132 | |
| David Tolnay | 7798969 | 2020-04-25 15:57:47 -0700 | [diff] [blame] | 133 | const rust::Vec<uint8_t> &c_return_ref_rust_vec(const C &c) { |
| 134 | (void)c; |
| 135 | throw std::runtime_error("unimplemented"); |
| 136 | } |
| 137 | |
| David Tolnay | 18d93b6 | 2020-08-27 00:55:48 -0700 | [diff] [blame] | 138 | rust::Vec<uint8_t> &c_return_mut_rust_vec(C &c) { |
| 139 | (void)c; |
| 140 | throw std::runtime_error("unimplemented"); |
| 141 | } |
| 142 | |
| David Tolnay | 33f56ad | 2020-08-27 17:06:35 -0700 | [diff] [blame] | 143 | rust::Vec<rust::String> c_return_rust_vec_string() { |
| 144 | throw std::runtime_error("unimplemented"); |
| 145 | } |
| 146 | |
| David Tolnay | 378ca50 | 2020-04-27 16:47:55 -0700 | [diff] [blame] | 147 | size_t c_return_identity(size_t n) { return n; } |
| Joel Galenson | ba67607 | 2020-04-27 15:55:45 -0700 | [diff] [blame] | 148 | |
| David Tolnay | 378ca50 | 2020-04-27 16:47:55 -0700 | [diff] [blame] | 149 | size_t c_return_sum(size_t n1, size_t n2) { return n1 + n2; } |
| Joel Galenson | ba67607 | 2020-04-27 15:55:45 -0700 | [diff] [blame] | 150 | |
| David Tolnay | f6a89f2 | 2020-05-10 23:39:27 -0700 | [diff] [blame] | 151 | Enum c_return_enum(uint16_t n) { |
| 152 | if (n <= static_cast<uint16_t>(Enum::AVal)) { |
| Joel Galenson | c03402a | 2020-04-23 17:31:09 -0700 | [diff] [blame] | 153 | return Enum::AVal; |
| David Tolnay | f6a89f2 | 2020-05-10 23:39:27 -0700 | [diff] [blame] | 154 | } else if (n <= static_cast<uint16_t>(Enum::BVal)) { |
| Joel Galenson | c03402a | 2020-04-23 17:31:09 -0700 | [diff] [blame] | 155 | return Enum::BVal; |
| 156 | } else { |
| 157 | return Enum::CVal; |
| 158 | } |
| 159 | } |
| 160 | |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 161 | ::A::AEnum c_return_ns_enum(uint16_t n) { |
| 162 | if (n <= static_cast<uint16_t>(::A::AEnum::AAVal)) { |
| 163 | return ::A::AEnum::AAVal; |
| 164 | } else if (n <= static_cast<uint16_t>(::A::AEnum::ABVal)) { |
| 165 | return ::A::AEnum::ABVal; |
| 166 | } else { |
| 167 | return ::A::AEnum::ACVal; |
| 168 | } |
| 169 | } |
| 170 | |
| 171 | ::A::B::ABEnum c_return_nested_ns_enum(uint16_t n) { |
| 172 | if (n <= static_cast<uint16_t>(::A::B::ABEnum::ABAVal)) { |
| 173 | return ::A::B::ABEnum::ABAVal; |
| 174 | } else if (n <= static_cast<uint16_t>(::A::B::ABEnum::ABBVal)) { |
| 175 | return ::A::B::ABEnum::ABBVal; |
| 176 | } else { |
| 177 | return ::A::B::ABEnum::ABCVal; |
| 178 | } |
| 179 | } |
| 180 | |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 181 | void c_take_primitive(size_t n) { |
| 182 | if (n == 2020) { |
| 183 | cxx_test_suite_set_correct(); |
| 184 | } |
| 185 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 186 | |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 187 | void c_take_shared(Shared shared) { |
| 188 | if (shared.z == 2020) { |
| 189 | cxx_test_suite_set_correct(); |
| 190 | } |
| 191 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 192 | |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 193 | void c_take_ns_shared(::A::AShared shared) { |
| 194 | if (shared.z == 2020) { |
| 195 | cxx_test_suite_set_correct(); |
| 196 | } |
| 197 | } |
| 198 | |
| 199 | void c_take_nested_ns_shared(::A::B::ABShared shared) { |
| 200 | if (shared.z == 2020) { |
| 201 | cxx_test_suite_set_correct(); |
| 202 | } |
| 203 | } |
| 204 | |
| David Tolnay | 750755e | 2020-03-01 13:04:08 -0800 | [diff] [blame] | 205 | void c_take_box(rust::Box<R> r) { |
| David Tolnay | a7d00e8 | 2020-03-06 15:50:14 -0800 | [diff] [blame] | 206 | if (cxx_test_suite_r_is_correct(&*r)) { |
| 207 | cxx_test_suite_set_correct(); |
| 208 | } |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 209 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 210 | |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 211 | void c_take_unique_ptr(std::unique_ptr<C> c) { |
| 212 | if (c->get() == 2020) { |
| 213 | cxx_test_suite_set_correct(); |
| 214 | } |
| 215 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 216 | |
| David Tolnay | a7d00e8 | 2020-03-06 15:50:14 -0800 | [diff] [blame] | 217 | void c_take_ref_r(const R &r) { |
| 218 | if (cxx_test_suite_r_is_correct(&r)) { |
| 219 | cxx_test_suite_set_correct(); |
| 220 | } |
| 221 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 222 | |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 223 | void c_take_ref_c(const C &c) { |
| 224 | if (c.get() == 2020) { |
| 225 | cxx_test_suite_set_correct(); |
| 226 | } |
| 227 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 228 | |
| Adrian Taylor | d47af7a | 2020-10-26 13:18:48 -0700 | [diff] [blame] | 229 | void c_take_ref_ns_c(const ::H::H &h) { |
| 230 | if (h.h == "hello") { |
| 231 | cxx_test_suite_set_correct(); |
| 232 | } |
| 233 | } |
| 234 | |
| David Tolnay | 750755e | 2020-03-01 13:04:08 -0800 | [diff] [blame] | 235 | void c_take_str(rust::Str s) { |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 236 | if (std::string(s) == "2020") { |
| 237 | cxx_test_suite_set_correct(); |
| 238 | } |
| 239 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 240 | |
| Adrian Taylor | f5dd552 | 2020-04-13 16:50:14 -0700 | [diff] [blame] | 241 | void c_take_sliceu8(rust::Slice<uint8_t> s) { |
| David Tolnay | 633b1f5 | 2020-04-14 16:33:14 -0700 | [diff] [blame] | 242 | if (std::string(reinterpret_cast<const char *>(s.data()), s.size()) == |
| 243 | "2020") { |
| Adrian Taylor | f5dd552 | 2020-04-13 16:50:14 -0700 | [diff] [blame] | 244 | cxx_test_suite_set_correct(); |
| 245 | } |
| 246 | } |
| 247 | |
| David Tolnay | 750755e | 2020-03-01 13:04:08 -0800 | [diff] [blame] | 248 | void c_take_rust_string(rust::String s) { |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 249 | if (std::string(s) == "2020") { |
| 250 | cxx_test_suite_set_correct(); |
| 251 | } |
| 252 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 253 | |
| David Tolnay | 3fd7f56 | 2020-01-26 17:47:11 -0800 | [diff] [blame] | 254 | void c_take_unique_ptr_string(std::unique_ptr<std::string> s) { |
| 255 | if (*s == "2020") { |
| 256 | cxx_test_suite_set_correct(); |
| 257 | } |
| 258 | } |
| David Tolnay | ad5b8af | 2020-01-26 16:59:13 -0800 | [diff] [blame] | 259 | |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 260 | void c_take_unique_ptr_vector_u8(std::unique_ptr<std::vector<uint8_t>> v) { |
| 261 | if (v->size() == 4) { |
| 262 | cxx_test_suite_set_correct(); |
| 263 | } |
| 264 | } |
| 265 | |
| 266 | void c_take_unique_ptr_vector_f64(std::unique_ptr<std::vector<double>> v) { |
| 267 | if (v->size() == 4) { |
| 268 | cxx_test_suite_set_correct(); |
| 269 | } |
| 270 | } |
| 271 | |
| David Tolnay | 47e239d | 2020-08-28 00:32:04 -0700 | [diff] [blame] | 272 | void c_take_unique_ptr_vector_string( |
| 273 | std::unique_ptr<std::vector<std::string>> v) { |
| 274 | (void)v; |
| 275 | cxx_test_suite_set_correct(); |
| 276 | } |
| 277 | |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 278 | void c_take_unique_ptr_vector_shared(std::unique_ptr<std::vector<Shared>> v) { |
| 279 | if (v->size() == 2) { |
| 280 | cxx_test_suite_set_correct(); |
| 281 | } |
| 282 | } |
| 283 | |
| David Tolnay | 2244d1f | 2020-04-25 13:58:18 -0700 | [diff] [blame] | 284 | void c_take_ref_vector(const std::vector<uint8_t> &v) { |
| 285 | if (v.size() == 4) { |
| 286 | cxx_test_suite_set_correct(); |
| 287 | } |
| 288 | } |
| 289 | |
| David Tolnay | d2ce8a9 | 2020-04-25 16:16:45 -0700 | [diff] [blame] | 290 | void c_take_rust_vec(rust::Vec<uint8_t> v) { c_take_ref_rust_vec(v); } |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 291 | |
| David Tolnay | 61adf42 | 2020-08-26 20:51:27 -0700 | [diff] [blame] | 292 | void c_take_rust_vec_index(rust::Vec<uint8_t> v) { |
| 293 | try { |
| 294 | v.at(100); |
| 295 | } catch (const std::out_of_range &ex) { |
| David Tolnay | 8e1e6ac | 2020-08-26 20:51:43 -0700 | [diff] [blame] | 296 | std::string expected = "rust::Vec index out of range"; |
| David Tolnay | 61adf42 | 2020-08-26 20:51:27 -0700 | [diff] [blame] | 297 | if (ex.what() == expected) { |
| 298 | cxx_test_suite_set_correct(); |
| 299 | } |
| 300 | } |
| 301 | } |
| Stephen Crane | 9e48d5b | 2020-08-21 12:17:02 -0700 | [diff] [blame] | 302 | |
| David Tolnay | d2ce8a9 | 2020-04-25 16:16:45 -0700 | [diff] [blame] | 303 | void c_take_rust_vec_shared(rust::Vec<Shared> v) { |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 304 | uint32_t sum = 0; |
| David Tolnay | c87c215 | 2020-04-24 17:07:41 -0700 | [diff] [blame] | 305 | for (auto i : v) { |
| Myron Ahn | eba35cf | 2020-02-05 19:41:51 +0700 | [diff] [blame] | 306 | sum += i.z; |
| 307 | } |
| 308 | if (sum == 2021) { |
| 309 | cxx_test_suite_set_correct(); |
| 310 | } |
| 311 | } |
| 312 | |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 313 | void c_take_rust_vec_ns_shared(rust::Vec<::A::AShared> v) { |
| 314 | uint32_t sum = 0; |
| 315 | for (auto i : v) { |
| 316 | sum += i.z; |
| 317 | } |
| 318 | if (sum == 2021) { |
| 319 | cxx_test_suite_set_correct(); |
| 320 | } |
| 321 | } |
| 322 | |
| 323 | void c_take_rust_vec_nested_ns_shared(rust::Vec<::A::B::ABShared> v) { |
| 324 | uint32_t sum = 0; |
| 325 | for (auto i : v) { |
| 326 | sum += i.z; |
| 327 | } |
| 328 | if (sum == 2021) { |
| 329 | cxx_test_suite_set_correct(); |
| 330 | } |
| 331 | } |
| 332 | |
| David Tolnay | 33f56ad | 2020-08-27 17:06:35 -0700 | [diff] [blame] | 333 | void c_take_rust_vec_string(rust::Vec<rust::String> v) { |
| 334 | (void)v; |
| 335 | cxx_test_suite_set_correct(); |
| 336 | } |
| 337 | |
| myronahn | da9be50 | 2020-04-29 05:47:23 +0700 | [diff] [blame] | 338 | void c_take_rust_vec_shared_forward_iterator(rust::Vec<Shared> v) { |
| 339 | // Exercise requirements of ForwardIterator |
| 340 | // https://en.cppreference.com/w/cpp/named_req/ForwardIterator |
| 341 | uint32_t sum = 0; |
| 342 | for (auto it = v.begin(), it_end = v.end(); it != it_end; it++) { |
| 343 | sum += it->z; |
| 344 | } |
| 345 | if (sum == 2021) { |
| 346 | cxx_test_suite_set_correct(); |
| 347 | } |
| 348 | } |
| 349 | |
| Stephen Crane | 9e48d5b | 2020-08-21 12:17:02 -0700 | [diff] [blame] | 350 | void c_take_rust_vec_shared_index(rust::Vec<Shared> v) { |
| David Tolnay | b10c4bc | 2020-08-26 21:55:29 -0700 | [diff] [blame] | 351 | if (v[0].z == 1010 && v.at(0).z == 1010 && v.front().z == 1010 && |
| 352 | v[1].z == 1011 && v.at(1).z == 1011 && v.back().z == 1011) { |
| Stephen Crane | 9e48d5b | 2020-08-21 12:17:02 -0700 | [diff] [blame] | 353 | cxx_test_suite_set_correct(); |
| 354 | } |
| 355 | } |
| 356 | |
| David Tolnay | d2ce8a9 | 2020-04-25 16:16:45 -0700 | [diff] [blame] | 357 | void c_take_ref_rust_vec(const rust::Vec<uint8_t> &v) { |
| 358 | uint8_t sum = std::accumulate(v.begin(), v.end(), 0); |
| 359 | if (sum == 200) { |
| 360 | cxx_test_suite_set_correct(); |
| 361 | } |
| 362 | } |
| 363 | |
| David Tolnay | 33f56ad | 2020-08-27 17:06:35 -0700 | [diff] [blame] | 364 | void c_take_ref_rust_vec_string(const rust::Vec<rust::String> &v) { |
| 365 | (void)v; |
| 366 | cxx_test_suite_set_correct(); |
| 367 | } |
| 368 | |
| Stephen Crane | 9e48d5b | 2020-08-21 12:17:02 -0700 | [diff] [blame] | 369 | void c_take_ref_rust_vec_index(const rust::Vec<uint8_t> &v) { |
| David Tolnay | b10c4bc | 2020-08-26 21:55:29 -0700 | [diff] [blame] | 370 | if (v[0] == 86 && v.at(0) == 86 && v.front() == 86 && v[1] == 75 && |
| 371 | v.at(1) == 75 && v[3] == 9 && v.at(3) == 9 && v.back() == 9) { |
| Stephen Crane | 9e48d5b | 2020-08-21 12:17:02 -0700 | [diff] [blame] | 372 | cxx_test_suite_set_correct(); |
| 373 | } |
| 374 | } |
| 375 | |
| myronahn | da9be50 | 2020-04-29 05:47:23 +0700 | [diff] [blame] | 376 | void c_take_ref_rust_vec_copy(const rust::Vec<uint8_t> &v) { |
| 377 | // The std::copy() will make sure rust::Vec<>::const_iterator satisfies the |
| 378 | // requirements for std::iterator_traits. |
| 379 | // https://en.cppreference.com/w/cpp/iterator/iterator_traits |
| David Tolnay | f5aeea2 | 2020-04-30 19:34:51 -0700 | [diff] [blame] | 380 | std::vector<uint8_t> stdv; |
| 381 | std::copy(v.begin(), v.end(), std::back_inserter(stdv)); |
| 382 | uint8_t sum = std::accumulate(stdv.begin(), stdv.end(), 0); |
| myronahn | da9be50 | 2020-04-29 05:47:23 +0700 | [diff] [blame] | 383 | if (sum == 200) { |
| 384 | cxx_test_suite_set_correct(); |
| 385 | } |
| 386 | } |
| 387 | |
| David Tolnay | 0c8c0f2 | 2020-07-21 17:57:46 -0700 | [diff] [blame] | 388 | /* |
| 389 | // https://github.com/dtolnay/cxx/issues/232 |
| David Tolnay | 75dca2e | 2020-03-25 20:17:52 -0700 | [diff] [blame] | 390 | void c_take_callback(rust::Fn<size_t(rust::String)> callback) { |
| 391 | callback("2020"); |
| 392 | } |
| David Tolnay | 0c8c0f2 | 2020-07-21 17:57:46 -0700 | [diff] [blame] | 393 | */ |
| David Tolnay | 75dca2e | 2020-03-25 20:17:52 -0700 | [diff] [blame] | 394 | |
| Joel Galenson | c03402a | 2020-04-23 17:31:09 -0700 | [diff] [blame] | 395 | void c_take_enum(Enum e) { |
| 396 | if (e == Enum::AVal) { |
| 397 | cxx_test_suite_set_correct(); |
| 398 | } |
| 399 | } |
| 400 | |
| Adrian Taylor | 9a158e4 | 2020-10-24 20:51:25 -0700 | [diff] [blame] | 401 | void c_take_ns_enum(::A::AEnum e) { |
| 402 | if (e == ::A::AEnum::AAVal) { |
| 403 | cxx_test_suite_set_correct(); |
| 404 | } |
| 405 | } |
| 406 | |
| 407 | void c_take_nested_ns_enum(::A::B::ABEnum e) { |
| 408 | if (e == ::A::B::ABEnum::ABAVal) { |
| 409 | cxx_test_suite_set_correct(); |
| 410 | } |
| 411 | } |
| 412 | |
| David Tolnay | ebef4a2 | 2020-03-17 15:33:47 -0700 | [diff] [blame] | 413 | void c_try_return_void() {} |
| 414 | |
| 415 | size_t c_try_return_primitive() { return 2020; } |
| 416 | |
| 417 | size_t c_fail_return_primitive() { throw std::logic_error("logic error"); } |
| 418 | |
| David Tolnay | 9964262 | 2020-03-25 13:07:35 -0700 | [diff] [blame] | 419 | rust::Box<R> c_try_return_box() { return c_return_box(); } |
| Myron Ahn | 8484930 | 2020-03-25 22:00:58 +0700 | [diff] [blame] | 420 | |
| David Tolnay | 9964262 | 2020-03-25 13:07:35 -0700 | [diff] [blame] | 421 | const rust::String &c_try_return_ref(const rust::String &s) { return s; } |
| 422 | |
| 423 | rust::Str c_try_return_str(rust::Str s) { return s; } |
| 424 | |
| Adrian Taylor | ec9430e | 2020-04-14 16:09:58 -0700 | [diff] [blame] | 425 | rust::Slice<uint8_t> c_try_return_sliceu8(rust::Slice<uint8_t> s) { return s; } |
| Adrian Taylor | f5dd552 | 2020-04-13 16:50:14 -0700 | [diff] [blame] | 426 | |
| David Tolnay | 9964262 | 2020-03-25 13:07:35 -0700 | [diff] [blame] | 427 | rust::String c_try_return_rust_string() { return c_return_rust_string(); } |
| 428 | |
| 429 | std::unique_ptr<std::string> c_try_return_unique_ptr_string() { |
| 430 | return c_return_unique_ptr_string(); |
| Myron Ahn | 8484930 | 2020-03-25 22:00:58 +0700 | [diff] [blame] | 431 | } |
| 432 | |
| David Tolnay | 8b9d176 | 2020-04-25 16:05:46 -0700 | [diff] [blame] | 433 | rust::Vec<uint8_t> c_try_return_rust_vec() { |
| 434 | throw std::runtime_error("unimplemented"); |
| 435 | } |
| 436 | |
| David Tolnay | 33f56ad | 2020-08-27 17:06:35 -0700 | [diff] [blame] | 437 | rust::Vec<rust::String> c_try_return_rust_vec_string() { |
| 438 | throw std::runtime_error("unimplemented"); |
| 439 | } |
| 440 | |
| David Tolnay | 7798969 | 2020-04-25 15:57:47 -0700 | [diff] [blame] | 441 | const rust::Vec<uint8_t> &c_try_return_ref_rust_vec(const C &c) { |
| 442 | (void)c; |
| 443 | throw std::runtime_error("unimplemented"); |
| 444 | } |
| 445 | |
| David Tolnay | 2fe58c6 | 2020-03-06 16:23:09 -0800 | [diff] [blame] | 446 | extern "C" C *cxx_test_suite_get_unique_ptr() noexcept { |
| David Tolnay | 4b3a66e | 2020-03-06 16:14:00 -0800 | [diff] [blame] | 447 | return std::unique_ptr<C>(new C{2020}).release(); |
| 448 | } |
| 449 | |
| David Tolnay | 85db2486 | 2020-03-06 16:24:41 -0800 | [diff] [blame] | 450 | extern "C" std::string *cxx_test_suite_get_unique_ptr_string() noexcept { |
| 451 | return std::unique_ptr<std::string>(new std::string("2020")).release(); |
| 452 | } |
| 453 | |
| David Tolnay | 3bbcdbb | 2020-10-09 19:29:44 -0700 | [diff] [blame] | 454 | rust::String C::cOverloadedMethod(int32_t x) const { |
| 455 | return rust::String(std::to_string(x)); |
| 456 | } |
| 457 | |
| 458 | rust::String C::cOverloadedMethod(rust::Str x) const { |
| 459 | return rust::String(std::string(x)); |
| 460 | } |
| 461 | |
| 462 | rust::String cOverloadedFunction(int x) { |
| 463 | return rust::String(std::to_string(x)); |
| 464 | } |
| 465 | |
| 466 | rust::String cOverloadedFunction(rust::Str x) { |
| 467 | return rust::String(std::string(x)); |
| 468 | } |
| 469 | |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 470 | void c_take_trivial_ptr(std::unique_ptr<D> d) { |
| 471 | if (d->d == 30) { |
| 472 | cxx_test_suite_set_correct(); |
| 473 | } |
| 474 | } |
| 475 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 476 | void c_take_trivial_ref(const D &d) { |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 477 | if (d.d == 30) { |
| 478 | cxx_test_suite_set_correct(); |
| 479 | } |
| 480 | } |
| Adrian Taylor | 585bb0b | 2020-10-26 13:17:17 -0700 | [diff] [blame] | 481 | |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 482 | void c_take_trivial(D d) { |
| 483 | if (d.d == 30) { |
| 484 | cxx_test_suite_set_correct(); |
| 485 | } |
| 486 | } |
| 487 | |
| Adrian Taylor | 585bb0b | 2020-10-26 13:17:17 -0700 | [diff] [blame] | 488 | void c_take_trivial_ns_ptr(std::unique_ptr<::G::G> g) { |
| 489 | if (g->g == 30) { |
| 490 | cxx_test_suite_set_correct(); |
| 491 | } |
| 492 | } |
| 493 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 494 | void c_take_trivial_ns_ref(const ::G::G &g) { |
| Adrian Taylor | 585bb0b | 2020-10-26 13:17:17 -0700 | [diff] [blame] | 495 | if (g.g == 30) { |
| 496 | cxx_test_suite_set_correct(); |
| 497 | } |
| 498 | } |
| 499 | |
| 500 | void c_take_trivial_ns(::G::G g) { |
| 501 | if (g.g == 30) { |
| 502 | cxx_test_suite_set_correct(); |
| 503 | } |
| 504 | } |
| 505 | |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 506 | void c_take_opaque_ptr(std::unique_ptr<E> e) { |
| 507 | if (e->e == 40) { |
| 508 | cxx_test_suite_set_correct(); |
| 509 | } |
| 510 | } |
| 511 | |
| Adrian Taylor | 5e79c64 | 2020-10-24 21:09:42 -0700 | [diff] [blame] | 512 | void c_take_opaque_ns_ptr(std::unique_ptr<::F::F> f) { |
| 513 | if (f->f == 40) { |
| 514 | cxx_test_suite_set_correct(); |
| 515 | } |
| 516 | } |
| 517 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 518 | void c_take_opaque_ref(const E &e) { |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 519 | if (e.e == 40 && e.e_str == "hello") { |
| 520 | cxx_test_suite_set_correct(); |
| 521 | } |
| 522 | } |
| 523 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 524 | void c_take_opaque_ns_ref(const ::F::F &f) { |
| Adrian Taylor | 5e79c64 | 2020-10-24 21:09:42 -0700 | [diff] [blame] | 525 | if (f.f == 40 && f.f_str == "hello") { |
| 526 | cxx_test_suite_set_correct(); |
| 527 | } |
| 528 | } |
| 529 | |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 530 | std::unique_ptr<D> c_return_trivial_ptr() { |
| 531 | auto d = std::unique_ptr<D>(new D()); |
| 532 | d->d = 30; |
| 533 | return d; |
| 534 | } |
| 535 | |
| 536 | D c_return_trivial() { |
| 537 | D d; |
| 538 | d.d = 30; |
| 539 | return d; |
| 540 | } |
| 541 | |
| Adrian Taylor | 585bb0b | 2020-10-26 13:17:17 -0700 | [diff] [blame] | 542 | std::unique_ptr<::G::G> c_return_trivial_ns_ptr() { |
| 543 | auto g = std::unique_ptr<::G::G>(new ::G::G()); |
| 544 | g->g = 30; |
| 545 | return g; |
| 546 | } |
| 547 | |
| 548 | ::G::G c_return_trivial_ns() { |
| 549 | ::G::G g; |
| 550 | g.g = 30; |
| 551 | return g; |
| 552 | } |
| 553 | |
| Adrian Taylor | 121cca4 | 2020-10-10 15:32:00 -0700 | [diff] [blame] | 554 | std::unique_ptr<E> c_return_opaque_ptr() { |
| 555 | auto e = std::unique_ptr<E>(new E()); |
| 556 | e->e = 40; |
| 557 | e->e_str = std::string("hello"); |
| 558 | return e; |
| 559 | } |
| 560 | |
| Adrian Taylor | 5e79c64 | 2020-10-24 21:09:42 -0700 | [diff] [blame] | 561 | std::unique_ptr<::F::F> c_return_ns_opaque_ptr() { |
| 562 | auto f = std::unique_ptr<::F::F>(new ::F::F()); |
| 563 | f->f = 40; |
| 564 | f->f_str = std::string("hello"); |
| 565 | return f; |
| 566 | } |
| 567 | |
| David Tolnay | f306da4 | 2020-02-22 19:55:43 -0800 | [diff] [blame] | 568 | extern "C" const char *cxx_run_test() noexcept { |
| 569 | #define STRINGIFY(x) #x |
| 570 | #define TOSTRING(x) STRINGIFY(x) |
| 571 | #define ASSERT(x) \ |
| 572 | do { \ |
| 573 | if (!(x)) { \ |
| 574 | return "Assertion failed: `" #x "`, " __FILE__ ":" TOSTRING(__LINE__); \ |
| 575 | } \ |
| 576 | } while (false) |
| 577 | |
| 578 | ASSERT(r_return_primitive() == 2020); |
| 579 | ASSERT(r_return_shared().z == 2020); |
| David Tolnay | 5cd8d61 | 2020-03-06 15:56:30 -0800 | [diff] [blame] | 580 | ASSERT(cxx_test_suite_r_is_correct(&*r_return_box())); |
| David Tolnay | 4b3a66e | 2020-03-06 16:14:00 -0800 | [diff] [blame] | 581 | ASSERT(r_return_unique_ptr()->get() == 2020); |
| David Tolnay | f306da4 | 2020-02-22 19:55:43 -0800 | [diff] [blame] | 582 | ASSERT(r_return_ref(Shared{2020}) == 2020); |
| 583 | ASSERT(std::string(r_return_str(Shared{2020})) == "2020"); |
| 584 | ASSERT(std::string(r_return_rust_string()) == "2020"); |
| David Tolnay | 85db2486 | 2020-03-06 16:24:41 -0800 | [diff] [blame] | 585 | ASSERT(*r_return_unique_ptr_string() == "2020"); |
| Joel Galenson | ba67607 | 2020-04-27 15:55:45 -0700 | [diff] [blame] | 586 | ASSERT(r_return_identity(2020) == 2020); |
| 587 | ASSERT(r_return_sum(2020, 1) == 2021); |
| Joel Galenson | c03402a | 2020-04-23 17:31:09 -0700 | [diff] [blame] | 588 | ASSERT(r_return_enum(0) == Enum::AVal); |
| 589 | ASSERT(r_return_enum(1) == Enum::BVal); |
| 590 | ASSERT(r_return_enum(2021) == Enum::CVal); |
| David Tolnay | f306da4 | 2020-02-22 19:55:43 -0800 | [diff] [blame] | 591 | |
| 592 | r_take_primitive(2020); |
| 593 | r_take_shared(Shared{2020}); |
| 594 | r_take_unique_ptr(std::unique_ptr<C>(new C{2020})); |
| 595 | r_take_ref_c(C{2020}); |
| David Tolnay | 750755e | 2020-03-01 13:04:08 -0800 | [diff] [blame] | 596 | r_take_str(rust::Str("2020")); |
| David Tolnay | 4037de2 | 2020-04-30 19:51:04 -0700 | [diff] [blame] | 597 | r_take_sliceu8(rust::Slice<uint8_t>( |
| 598 | reinterpret_cast<const uint8_t *>(SLICE_DATA), sizeof(SLICE_DATA))); |
| David Tolnay | 40226ab | 2020-03-03 00:05:35 -0800 | [diff] [blame] | 599 | r_take_rust_string(rust::String("2020")); |
| David Tolnay | f306da4 | 2020-02-22 19:55:43 -0800 | [diff] [blame] | 600 | r_take_unique_ptr_string( |
| 601 | std::unique_ptr<std::string>(new std::string("2020"))); |
| David Tolnay | 5df0a71 | 2020-09-24 15:58:28 -0400 | [diff] [blame] | 602 | r_take_ref_vector(std::vector<uint8_t>{20, 2, 0}); |
| David Tolnay | 80631e9 | 2020-09-24 16:07:30 -0400 | [diff] [blame] | 603 | std::vector<uint64_t> empty_vector; |
| 604 | r_take_ref_empty_vector(empty_vector); |
| 605 | empty_vector.reserve(10); |
| 606 | r_take_ref_empty_vector(empty_vector); |
| Joel Galenson | c03402a | 2020-04-23 17:31:09 -0700 | [diff] [blame] | 607 | r_take_enum(Enum::AVal); |
| David Tolnay | f306da4 | 2020-02-22 19:55:43 -0800 | [diff] [blame] | 608 | |
| David Tolnay | b6c5ea7 | 2020-03-16 13:36:28 -0700 | [diff] [blame] | 609 | ASSERT(r_try_return_primitive() == 2020); |
| 610 | try { |
| 611 | r_fail_return_primitive(); |
| 612 | ASSERT(false); |
| 613 | } catch (const rust::Error &e) { |
| 614 | ASSERT(std::strcmp(e.what(), "rust error") == 0); |
| 615 | } |
| 616 | |
| Joel Galenson | c1c4e7a | 2020-04-15 10:21:00 -0700 | [diff] [blame] | 617 | auto r2 = r_return_r2(2020); |
| 618 | ASSERT(r2->get() == 2020); |
| 619 | ASSERT(r2->set(2021) == 2021); |
| 620 | ASSERT(r2->get() == 2021); |
| 621 | ASSERT(r2->set(2020) == 2020); |
| 622 | ASSERT(r2->get() == 2020); |
| 623 | |
| David Tolnay | 3bbcdbb | 2020-10-09 19:29:44 -0700 | [diff] [blame] | 624 | ASSERT(std::string(rAliasedFunction(2020)) == "2020"); |
| 625 | |
| David Tolnay | f306da4 | 2020-02-22 19:55:43 -0800 | [diff] [blame] | 626 | cxx_test_suite_set_correct(); |
| 627 | return nullptr; |
| 628 | } |
| 629 | |
| David Tolnay | 97c7210 | 2020-01-25 16:49:00 -0800 | [diff] [blame] | 630 | } // namespace tests |
| Adrian Taylor | ddc146e | 2020-10-25 21:40:17 -0700 | [diff] [blame] | 631 | |
| 632 | namespace other { |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 633 | void ns_c_take_trivial(::tests::D d) { |
| 634 | if (d.d == 30) { |
| 635 | cxx_test_suite_set_correct(); |
| Adrian Taylor | ddc146e | 2020-10-25 21:40:17 -0700 | [diff] [blame] | 636 | } |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 637 | } |
| Adrian Taylor | ddc146e | 2020-10-25 21:40:17 -0700 | [diff] [blame] | 638 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 639 | ::tests::D ns_c_return_trivial() { |
| 640 | ::tests::D d; |
| 641 | d.d = 30; |
| 642 | return d; |
| 643 | } |
| Adrian Taylor | ddc146e | 2020-10-25 21:40:17 -0700 | [diff] [blame] | 644 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 645 | void ns_c_take_ns_shared(::A::AShared shared) { |
| 646 | if (shared.z == 2020) { |
| 647 | cxx_test_suite_set_correct(); |
| Adrian Taylor | ddc146e | 2020-10-25 21:40:17 -0700 | [diff] [blame] | 648 | } |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 649 | } |
| Adrian Taylor | 0fac321 | 2020-10-25 21:52:55 -0700 | [diff] [blame] | 650 | } // namespace other |
| 651 | |
| 652 | namespace I { |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 653 | uint32_t I::get() const { return a; } |
| Adrian Taylor | 0fac321 | 2020-10-25 21:52:55 -0700 | [diff] [blame] | 654 | |
| David Tolnay | bf23e3e | 2020-10-30 21:09:16 -0700 | [diff] [blame^] | 655 | std::unique_ptr<I> ns_c_return_unique_ptr_ns() { |
| 656 | return std::unique_ptr<I>(new I()); |
| 657 | } |
| Adrian Taylor | 0fac321 | 2020-10-25 21:52:55 -0700 | [diff] [blame] | 658 | } // namespace I |