Method create

rust/src/custom_binary_view.rs:496–906

Begins creating a custom BinaryView. This function may only be called from the `create_custom_view` function of a `CustomBinaryViewType`. `parent` specifies the view that the core will treat as the parent view, that Segments created against the created view will be backed by `parent`. It will usually be (but is not required to be) the `data` argument of the `create_custom_view` callback. `const

(self, parent: &BinaryView, view_args: V::Args)

    /// to be returned by the `AsRef<BinaryView>` implementation required by the `BinaryViewBase` trait.
    ///  TODO FIXME whelp this is broke going to need 2 init callbacks
    pub fn create<V>(self, parent: &BinaryView, view_args: V::Args) -> Result<CustomView<'a>>
    where
        V: CustomBinaryView,
    {
        let file = self.actual_parent.file();
        let view_type = self.view_type;

        let view_name = view_type.name();

        if let Some(bv) = file.view_of_type(view_name.as_str()) {
            // while it seems to work most of the time, you can get really unlucky
            // if the a free of the existing view of the same type kicks off while
            // BNCreateBinaryViewOfType is still running. the freeObject callback
            // will run for the new view before we've even finished initializing,
            // and that's all she wrote.
            //
            // even if we deal with it gracefully in cb_free_object,
            // BNCreateBinaryViewOfType is still going to crash, so we're just
            // going to try and stop this from happening in the first place.
            log::error!(
                "attempt to create duplicate view of type '{}' (existing: {:?})",
                view_name.as_str(),
                bv.handle
            );

            return Err(());
        }

        // struct representing the context of a BNCustomBinaryView. Can be safely
        // dropped at any moment.
        struct CustomViewContext<V>
        where
            V: CustomBinaryView,
        {
            raw_handle: *mut BNBinaryView,
            state: CustomViewContextState<V>,
        }

        enum CustomViewContextState<V>
        where
            V: CustomBinaryView,
        {
            Uninitialized { args: V::Args },
            Initialized { view: V },
            // dummy state, used as a helper to change states, only happen if the
            // `new` or `init` function fails.
            None,
        }

        impl<V: CustomBinaryView> CustomViewContext<V> {
            fn assume_init_ref(&self) -> &V {
                let CustomViewContextState::Initialized { view } = &self.state else {
                    panic!("CustomViewContextState in invalid state");
                };
                view
            }
        }