[#532] Add debug_assert and fix C++ docu

examples/cxx/publish_subscribe_dynamic_data/README.md

@@ -15,9 +15,9 @@ allowing users to send samples of arbitrary sizes.
 > * have a uniform memory representation -> `#[repr(C)]`
 > * not use pointers to manage their internal structure
 >
-> Data types like `String` or `Vec` will cause undefined behavior and may
-> result in segmentation faults. We provide alternative data types that are
-> compatible with shared memory. See the
+> Data types like `std::string` or `std::vector` will cause undefined behavior
+> and may result in segmentation faults. We provide alternative data types
+> that are compatible with shared memory. See the
 > [complex data type example](../complex_data_types) for guidance on how to
 > use them.
 

iceoryx2/src/port/publisher.rs

@@ -261,6 +261,7 @@ impl SegmentState {
     }
 
     fn sample_index(&self, distance_to_chunk: usize) -> usize {
+        debug_assert!(distance_to_chunk % self.payload_size() == 0);
         distance_to_chunk / self.payload_size()
     }