nautilus_model/ffi/identifiers/venue.rs
1// -------------------------------------------------------------------------------------------------
2// Copyright (C) 2015-2025 Posei Systems Pty Ltd. All rights reserved.
3// https://poseitrader.io
4//
5// Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6// You may not use this file except in compliance with the License.
7// You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16use std::ffi::c_char;
17
18use nautilus_core::ffi::string::cstr_as_str;
19
20use crate::{identifiers::Venue, venues::VENUE_MAP};
21
22/// Returns a Posei identifier from a C string pointer.
23///
24/// # Safety
25///
26/// Assumes `ptr` is a valid C string pointer.
27#[unsafe(no_mangle)]
28pub unsafe extern "C" fn venue_new(ptr: *const c_char) -> Venue {
29 let value = unsafe { cstr_as_str(ptr) };
30 Venue::from(value)
31}
32
33#[unsafe(no_mangle)]
34pub extern "C" fn venue_hash(id: &Venue) -> u64 {
35 id.inner().precomputed_hash()
36}
37
38#[unsafe(no_mangle)]
39pub extern "C" fn venue_is_synthetic(venue: &Venue) -> u8 {
40 u8::from(venue.is_synthetic())
41}
42
43/// Checks if a venue code exists in the internal map.
44///
45/// # Safety
46///
47/// Assumes `code_ptr` is a valid NUL-terminated UTF-8 C string pointer.
48///
49/// # Panics
50///
51/// Panics if the internal mutex `VENUE_MAP` is poisoned.
52#[unsafe(no_mangle)]
53pub unsafe extern "C" fn venue_code_exists(code_ptr: *const c_char) -> u8 {
54 let code = unsafe { cstr_as_str(code_ptr) };
55 u8::from(VENUE_MAP.lock().unwrap().contains_key(code))
56}
57
58/// Converts a UTF-8 C string pointer to a `Venue`.
59///
60/// # Safety
61///
62/// Assumes `code_ptr` is a valid NUL-terminated UTF-8 C string pointer.
63///
64/// # Panics
65///
66/// Panics if the code is not found or invalid (unwrap on `from_code`).
67#[unsafe(no_mangle)]
68pub unsafe extern "C" fn venue_from_cstr_code(code_ptr: *const c_char) -> Venue {
69 let code = unsafe { cstr_as_str(code_ptr) };
70 Venue::from_code(code).unwrap()
71}