#include <BLI_span.hh>

Inherited by blender::VArraySpan< T >.

Public Types
using	value_type = T
using	pointer = T *
using	const_pointer = const T *
using	reference = T &
using	const_reference = const T &
using	iterator = const T *
using	size_type = int64_t

Public Member Functions
constexpr	Span ()=default
constexpr	Span (const T *start, int64_t size)
template<typename U, BLI_ENABLE_IF((is_span_convertible_pointer_v< U, T >))>
constexpr	Span (const U *start, int64_t size)
constexpr	Span (const std::initializer_list< T > &list)
constexpr	Span (const std::vector< T > &vector)
template<std::size_t N>
constexpr	Span (const std::array< T, N > &array)
template<typename U, BLI_ENABLE_IF((is_span_convertible_pointer_v< U, T >))>
constexpr	Span (Span< U > span)
constexpr Span	slice (int64_t start, int64_t size) const
constexpr Span	slice (IndexRange range) const
constexpr Span	slice_safe (const int64_t start, const int64_t size) const
constexpr Span	slice_safe (IndexRange range) const
constexpr Span	drop_front (int64_t n) const
constexpr Span	drop_back (int64_t n) const
constexpr Span	take_front (int64_t n) const
constexpr Span	take_back (int64_t n) const
constexpr const T *	data () const
constexpr const T *	begin () const
constexpr const T *	end () const
constexpr std::reverse_iterator< const T * >	rbegin () const
constexpr std::reverse_iterator< const T * >	rend () const
constexpr const T &	operator[] (int64_t index) const
constexpr int64_t	size () const
constexpr bool	is_empty () const
constexpr int64_t	size_in_bytes () const
constexpr bool	contains (const T &value) const
constexpr bool	contains_ptr (const T *ptr) const
constexpr int64_t	count (const T &value) const
constexpr const T &	first () const
constexpr const T &	last (const int64_t n=0) const
constexpr bool	has_duplicates__linear_search () const
constexpr bool	intersects__linear_search (Span other) const
constexpr int64_t	first_index (const T &search_value) const
constexpr int64_t	first_index_try (const T &search_value) const
constexpr IndexRange	index_range () const
constexpr uint64_t	hash () const
template<typename NewT>
Span< NewT > constexpr	cast () const

Protected Attributes
const T *	data_ = nullptr
int64_t	size_ = 0

Friends
bool	operator== (const Span< T > a, const Span< T > b)
bool	operator!= (const Span< T > a, const Span< T > b)

Detailed Description

template<typename T>
class blender::Span< T >

References an array of type T that is owned by someone else. The data in the array cannot be modified.

Definition at line 74 of file BLI_span.hh.

Member Typedef Documentation

◆ const_pointer

template<typename T>

using blender::Span< T >::const_pointer = const T *

Definition at line 78 of file BLI_span.hh.

◆ const_reference

template<typename T>

using blender::Span< T >::const_reference = const T &

Definition at line 80 of file BLI_span.hh.

◆ iterator

template<typename T>

using blender::Span< T >::iterator = const T *

Definition at line 81 of file BLI_span.hh.

◆ pointer

template<typename T>

using blender::Span< T >::pointer = T *

Definition at line 77 of file BLI_span.hh.

◆ reference

template<typename T>

using blender::Span< T >::reference = T &

Definition at line 79 of file BLI_span.hh.

◆ size_type

template<typename T>

using blender::Span< T >::size_type = int64_t

Definition at line 82 of file BLI_span.hh.

◆ value_type

template<typename T>

using blender::Span< T >::value_type = T

Definition at line 76 of file BLI_span.hh.

Constructor & Destructor Documentation

◆ Span() [1/7]

template<typename T>

blender::Span< T >::Span ( )

constexprdefault

Create a reference to an empty array.

Referenced by cast(), drop_back(), drop_front(), intersects__linear_search(), operator!=, operator==, slice(), slice(), slice_safe(), slice_safe(), Span(), Span(), Span(), Span(), take_back(), take_front(), and blender::VArraySpan< T >::VArraySpan().

◆ Span() [2/7]

template<typename T>

blender::Span< T >::Span	(	const T *	start,
		int64_t	size )

inlineconstexpr

Definition at line 94 of file BLI_span.hh.

References BLI_assert, data_, size(), size_, and T.

◆ Span() [3/7]

template<typename T>

template<typename U, BLI_ENABLE_IF((is_span_convertible_pointer_v< U, T >))>

blender::Span< T >::Span	(	const U *	start,
		int64_t	size )

inlineconstexpr

Definition at line 100 of file BLI_span.hh.

References BLI_assert, data_, size(), size_, T, and U.

◆ Span() [4/7]

template<typename T>

blender::Span< T >::Span ( const std::initializer_list< T > & list )

inlineconstexpr

Reference an initializer_list. Note that the data in the initializer_list is only valid until the expression containing it is fully computed.

Do: call_function_with_array({1, 2, 3, 4});

Don't: Span<int> span = {1, 2, 3, 4}; call_function_with_array(span);

Definition at line 116 of file BLI_span.hh.

References begin(), size(), and Span().

◆ Span() [5/7]

template<typename T>

blender::Span< T >::Span ( const std::vector< T > & vector )

inlineconstexpr

Definition at line 120 of file BLI_span.hh.

References data(), size(), and Span().

◆ Span() [6/7]

template<typename T>

template<std::size_t N>

blender::Span< T >::Span ( const std::array< T, N > & array )

inlineconstexpr

Definition at line 122 of file BLI_span.hh.

References data(), N, and Span().

◆ Span() [7/7]

template<typename T>

template<typename U, BLI_ENABLE_IF((is_span_convertible_pointer_v< U, T >))>

blender::Span< T >::Span ( Span< U > span )

inlineconstexpr

Support implicit conversions like the one below: Span<T *> -> Span<const T *>

Definition at line 129 of file BLI_span.hh.

References data(), data_, size(), size_, Span(), and T.

Member Function Documentation

◆ begin()

template<typename T>

const T * blender::Span< T >::begin ( ) const

inlineconstexpr

Definition at line 220 of file BLI_span.hh.

References data_, and T.

◆ cast()

template<typename T>

template<typename NewT>

Span< NewT > constexpr blender::Span< T >::cast ( ) const

inlineconstexpr

Returns a new Span to the same underlying memory buffer. No conversions are done.

Definition at line 418 of file BLI_span.hh.

References BLI_assert, data_, size_, Span(), and T.

Referenced by blender::bke::BoneDeformLinearMixer< full_deform >::accumulate_bbone(), blender::ed::sculpt_paint::apply_translations(), blender::ed::sculpt_paint::apply_translations(), blender::ed::sculpt_paint::apply_translations(), attr_create_generic(), blender::bke::mesh::build_vert_to_edge_map(), blender::nodes::node_fn_separate_matrix_cc::SeparateMatrixFunction::call(), blender::geometry::edges_to_curve_point_indices(), blender::draw::extract_edituv_tris_mesh(), blender::draw::extract_tris_mesh(), blender::animrig::fcurve_find(), blender::geometry::fit_poly_to_bezier_curves(), blender::fn::lazy_function::Graph::function_nodes(), blender::fn::lazy_function::Graph::function_nodes(), blender::io::grease_pencil::get_average(), blender::geometry::mesh_triangulate(), operator<<(), blender::bits::or_bools_into_bits(), blender::fn::multi_function::Procedure::params(), blender::io::usd::USDCurveData::points(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), blender::io::usd::USDPointInstancerReader::read_geometry(), blender::io::usd::USDPointsReader::read_geometry(), blender::io::grease_pencil::shape_attributes_to_curves(), subdivide_base(), blender::tests::TEST(), blender::tests::TEST(), blender::tests::TEST(), blender::io::usd::USDCurveData::velocities(), blender::bke::mesh::vert_tris_from_corner_tris(), blender::io::hydra::CurvesData::write_curves(), and blender::io::ply::FileBufferBinary::write_face().

◆ contains()

template<typename T>

bool blender::Span< T >::contains ( const T & value ) const

inlineconstexpr

Does a linear search to see of the value is in the array. Returns true if it is, otherwise false.

Definition at line 277 of file BLI_span.hh.

References element, and T.

Referenced by blender::bke::attribute_filter_from_skip_ref(), blender::bke::attribute_filter_with_skip_ref(), BKE_grease_pencil_material_index_used(), BKE_mesh_material_index_used(), blender::fn::build_multi_function_procedure_for_fields(), blender::ed::sculpt_paint::face_set::change_visibility_exec(), blender::nodes::GeoNodeExecParams::check_input_geometry_set(), blender::bke::discover_tree_zones(), blender::draw::draw_subdiv_create_requested_buffers(), blender::draw::ensure_dependency_data(), blender::nodes::LazyFunctionForViewerInputUsage::execute_impl(), blender::csv_parse::detail::find_end_of_quoted_field(), blender::ed::space_node::viewer_linking::find_overlapping_node(), blender::geometry::get_final_attribute_info(), blender::ed::space_node::get_new_linked_node(), blender::nodes::gizmo_is_used(), blender::ed::greasepencil::grease_pencil_copy_strokes_exec(), intersects__linear_search(), blender::nodes::node_geo_sort_elements_cc::items_value_in(), blender::bke::GeometrySet::keep_only(), blender::seq::query_overwrite_targets(), blender::seq::query_right_side_strips(), blender::ed::curves::selection_attribute_writer_by_name(), blender::tests::TEST(), blender::nodes::CombineBundleItemsAccessor::validate_name(), and blender::bke::write_sharp_bezier_edges().

◆ contains_ptr()

template<typename T>

bool blender::Span< T >::contains_ptr ( const T * ptr ) const

inlineconstexpr

Does a constant time check to see if the pointer points to a value in the referenced array. Return true if it is, otherwise false.

Definition at line 291 of file BLI_span.hh.

References begin(), end(), ptr, and T.

Referenced by BKE_attribute_data_length(), BKE_attribute_domain(), and blender::tests::TEST().

◆ count()

template<typename T>

int64_t blender::Span< T >::count ( const T & value ) const

inlineconstexpr

Does a linear search to count how often the value is in the array. Returns the number of occurrences.

Definition at line 300 of file BLI_span.hh.

References element, and T.

Referenced by blender::nodes::node_geo_remove_attribute_cc::node_geo_exec(), and blender::tests::TEST().

◆ data()

template<typename T>

const T * blender::Span< T >::data ( ) const

inlineconstexpr

Returns the pointer to the beginning of the referenced array. This may be nullptr when the size is zero.

Definition at line 215 of file BLI_span.hh.

References data_, and T.

Referenced by blender::geometry::PackIsland::add_polygon(), blender::ed::object::armature_coords_and_quats_apply_with_mat4(), blender::draw::overlay::Background::begin_sync(), BKE_keyblock_data_set_with_mat4(), BKE_keyblock_update_from_mesh(), BKE_mesh_is_valid(), BKE_mesh_remap_calc_loops_from_mesh(), BKE_mesh_runtime_is_valid(), BKE_mesh_validate(), BLI_lasso_is_point_inside(), blender::geometry::ngon::calc_corner_tris(), blender::ed::transform::calcEdgeSlide_mval_range(), blender::draw::detail::PassBase< DrawCommandBufType >::clear_multi(), blender::LinearAllocator< Allocator >::construct_array_copy(), blender::gpu::convert_buffer(), blender::MutableSpan< T >::copy_from(), blender::bke::idprop::create_array(), create_mesh(), blender::draw::curve_create_curves_pos(), CustomData_blend_write(), blender::index_mask::difference_index_mask_segments(), distribute_from_volume_exec(), dynamicPaint_createUVSurface(), dynamicPaint_generateBakeData(), ED_mesh_pick_face_vert(), blender::ed::object::edit_armature_coords_and_quats_apply_with_mat4(), export_hair_curves(), export_pointcloud(), blender::Vector< SubdivCCGCoord, 256 >::extend(), blender::Vector< SubdivCCGCoord, 256 >::extend_unchecked(), blender::draw::extract_face_dot_index(), blender::geometry::extract_mesh_faces(), face_edge_loop_islands_calc(), blender::csv_parse::CsvRecord::field_str(), blender::draw::pbvh::fill_masks_grids(), blender::draw::pbvh::fill_positions_grids(), blender::ed::sculpt_paint::undo::compression::filter_compress(), blender::ed::sculpt_paint::undo::compression::filter_decompress(), find_all_ranges_test(), blender::VArray< T >::from_derived_span(), get_dupliface_transform_from_coords(), BlenderDisplayDriver::graphics_interop_get_device(), blender::draw::interpolate(), blender::ed::mesh::join_generic_attributes(), blender::ed::mesh::join_shape_keys(), blender::ed::mesh::join_vertex_groups(), blender::io::ply::load_face_element(), blender::io::ply::load_tristrips_element(), mesh_calc_eigen_matrix(), mesh_calc_hq_normal(), blender::ed::object::metaball_coords_and_quats_apply_with_mat4(), MOD_solidify_nonmanifold_modifyMesh(), blender::ed::object::modifier_skin_armature_create(), modify_mesh(), modify_mesh(), modify_mesh(), modify_mesh(), blender::bits::or_bytes_into_bits(), blender::io::ply::parse_row_ascii(), blender::bke::pbvh::pbvh_bmesh_face_create(), blender::ed::greasepencil::polyline_detect_corners(), blender::ed::greasepencil::polyline_fit_curve(), psys_particle_on_dm(), blender::Stack< T, InlineBufferCapacity, RawAllocator >< RawVector< FunctionRef< void()>, 0 >, 0 >::push_multiple(), PyC_Tuple_Pack_Bool(), PyC_Tuple_Pack_F32(), PyC_Tuple_Pack_F64(), PyC_Tuple_Pack_I32(), PyC_Tuple_Pack_I32FromBool(), RE_engine_get_current_tiles(), blender::bke::bake::MemoryBlobReader::read(), blender::io::ply::read_header(), RNA_property_boolean_set_array(), RNA_property_float_set_array(), RNA_property_int_set_array(), blender::io::obj::OBJCurvesTest::run_nurbs_test(), sculpt_update_object(), blender::VMutableArrayImpl< T >::set_all(), blender::io::obj::set_property_of_socket(), shrinkwrapParams_deform(), Span(), Span(), Span(), blender::draw::statvis_calc_thickness(), blender::bke::tests::TEST(), blender::tests::TEST(), blender::draw::test_eevee_lut_gen(), blender::io::ply::type_from_string(), blender::gpu::GLTexture::update_sub(), blender::gpu::MTLTexture::update_sub(), view3d_lasso_select(), blender::bke::write_channelbag(), blender::bke::write_layers(), blender::bke::write_slots(), blender::bke::write_strip_keyframe_data_array(), and blender::bke::write_strips().

◆ drop_back()

template<typename T>

Span blender::Span< T >::drop_back ( int64_t n ) const

inlineconstexpr

Returns a new Span with n elements removed from the end. This invokes undefined behavior when n is negative.

Definition at line 182 of file BLI_span.hh.

References BLI_assert, data_, size_, and Span().

Referenced by blender::ed::sculpt_paint::greasepencil::PaintOperationExecutor::active_smoothing(), blender::io::obj::detect_knot_mode_bezier_clamped(), blender::io::obj::detect_knot_mode_cyclic(), blender::io::obj::detect_knot_mode_uniform(), blender::io::grease_pencil::extend_curves_geometry(), blender::ed::space_node::node_errors_tooltip_fn(), blender::ed::viewer_path::parse_geometry_nodes_viewer(), blender::bke::node_tree_reference_lifetimes::prepare_required_data_for_group_outputs(), blender::ed::sculpt_paint::greasepencil::sample_curve_2d(), blender::tests::TEST(), blender::tests::TEST(), and blender::io::obj::valid_nurb_control_point_range().

◆ drop_front()

template<typename T>

Span blender::Span< T >::drop_front ( int64_t n ) const

inlineconstexpr

Returns a new Span with n elements removed from the beginning. This invokes undefined behavior when n is negative.

Definition at line 171 of file BLI_span.hh.

References BLI_assert, data_, size_, and Span().

Referenced by blender::ed::sculpt_paint::greasepencil::PaintOperationExecutor::active_smoothing(), blender::fn::multi_function::ProcedureBuilder::add_call(), blender::io::usd::calc_curve_offsets(), blender::ed::curves::curve_offsets_from_selection(), blender::io::obj::detect_knot_mode_bezier_clamped(), blender::io::obj::detect_knot_mode_cyclic(), blender::io::obj::detect_knot_mode_uniform(), blender::ed::curves::extend_range_by_1_within_bounds(), blender::fill_scene_range_chain(), blender::index_mask::IndexMask::foreach_range(), blender::index_mask::IndexMask::from_segments(), blender::fn::lazy_function::Graph::function_nodes(), blender::fn::lazy_function::Graph::function_nodes(), blender::geometry::gather_or_reference(), blender::ed::curves::invert_ranges(), blender::nodes::Bundle::lookup_path(), blender::csv_parse::parse_csv_in_chunks(), blender::ed::viewer_path::parse_geometry_nodes_viewer(), blender::Stack< T, InlineBufferCapacity, RawAllocator >< RawVector< FunctionRef< void()>, 0 >, 0 >::push_multiple(), blender::geometry::reinsert_modified_geometry_recursive(), blender::ed::sculpt_paint::greasepencil::sample_curve_2d(), blender::string_search::score_query_against_words(), blender::index_mask::segments_from_indices(), blender::unique_sorted_indices::split_to_ranges_and_spans(), blender::tests::TEST(), blender::tests::TEST(), blender::tests::TEST(), and blender::io::obj::valid_nurb_control_point_range().

◆ end()

template<typename T>

const T * blender::Span< T >::end ( ) const

inlineconstexpr

Definition at line 224 of file BLI_span.hh.

References data_, size_, and T.

◆ first()

template<typename T>

const T & blender::Span< T >::first ( ) const

inlineconstexpr

Return a reference to the first element in the array. This invokes undefined behavior when the array is empty.

Definition at line 315 of file BLI_span.hh.

References BLI_assert, data_, size_, and T.

◆ first_index()

template<typename T>

int64_t blender::Span< T >::first_index ( const T & search_value ) const

inlineconstexpr

Returns the index of the first occurrence of the given value. This invokes undefined behavior when the value is not in the array.

Definition at line 377 of file BLI_span.hh.

References BLI_assert, first_index_try(), and T.

Referenced by blender::geometry::calc_corner_groups_for_vertex(), blender::bke::mesh::face_find_corner_from_vert(), get_opposing_edge_index(), blender::ed::greasepencil::grease_pencil_delete_breakdown_frames_exec(), blender::ed::space_node::node_select_same_type_step_exec(), blender::ed::spreadsheet::reorder_columns_invoke(), blender::ed::spreadsheet::reorder_columns_modal(), blender::ed::spreadsheet::spreadsheet_table_move_to_front(), blender::tests::TEST(), blender::tests::TEST(), blender::ed::view3d::geometry_nodes_gizmos::TransformGizmos::update_rotate_transform_and_target_property(), blender::ed::view3d::geometry_nodes_gizmos::TransformGizmos::update_scale_transform_and_target_property(), and blender::ed::view3d::geometry_nodes_gizmos::TransformGizmos::update_translate_transform_and_target_property().

◆ first_index_try()

template<typename T>

int64_t blender::Span< T >::first_index_try ( const T & search_value ) const

inlineconstexpr

Returns the index of the first occurrence of the given value or -1 if it does not exist.

Definition at line 387 of file BLI_span.hh.

References data_, i, size_, and T.

Referenced by blender::nodes::node_geo_set_material_cc::assign_material_to_id_geometry(), first_index(), and blender::ed::greasepencil::merge_layers().

◆ has_duplicates__linear_search()

template<typename T>

bool blender::Span< T >::has_duplicates__linear_search ( ) const

inlineconstexpr

Check if the array contains duplicates. Does a linear search for every element. So the total running time is O(n^2). Only use this for small arrays.

Definition at line 336 of file BLI_span.hh.

References BLI_assert, data_, i, size_, and T.

Referenced by blender::tests::TEST().

◆ hash()

template<typename T>

uint64_t blender::Span< T >::hash ( ) const

inlineconstexpr

Definition at line 406 of file BLI_span.hh.

References blender::get_default_hash(), hash(), and T.

Referenced by hash(), blender::Array< Slot, LoadFactor::compute_total_slots(InlineBufferCapacity, LOAD_FACTOR), Allocator >::hash_as(), and blender::Vector< SubdivCCGCoord, 256 >::hash_as().

◆ index_range()

template<typename T>

IndexRange blender::Span< T >::index_range ( ) const

inlineconstexpr

Utility to make it more convenient to iterate over all indices that can be used with this array.

Definition at line 401 of file BLI_span.hh.

References size_.

◆ intersects__linear_search()

template<typename T>

bool blender::Span< T >::intersects__linear_search ( Span< T > other ) const

inlineconstexpr

Returns true when this and the other array have an element in common. This should only be called on small arrays, because it has a running time of O(n*m) where n and m are the sizes of the arrays.

Definition at line 358 of file BLI_span.hh.

References BLI_assert, contains(), data_, i, size_, Span(), and T.

◆ is_empty()

template<typename T>

bool blender::Span< T >::is_empty ( ) const

inlineconstexpr

Returns true if the size is zero.

Definition at line 260 of file BLI_span.hh.

References size_.

◆ last()

template<typename T>

const T & blender::Span< T >::last ( const int64_t n = 0 ) const

inlineconstexpr

Returns a reference to the nth last element. This invokes undefined behavior when the span is too short.

Definition at line 325 of file BLI_span.hh.

References BLI_assert, data_, size_, and T.

◆ operator[]()

template<typename T>

const T & blender::Span< T >::operator[] ( int64_t index ) const

inlineconstexpr

Access an element in the array. This invokes undefined behavior when the index is out of bounds.

Definition at line 242 of file BLI_span.hh.

References BLI_assert, data_, size_, and T.

◆ rbegin()

template<typename T>

std::reverse_iterator< const T * > blender::Span< T >::rbegin ( ) const

inlineconstexpr

Definition at line 229 of file BLI_span.hh.

References end().

Referenced by blender::tests::TEST().

◆ rend()

template<typename T>

std::reverse_iterator< const T * > blender::Span< T >::rend ( ) const

inlineconstexpr

Definition at line 233 of file BLI_span.hh.

References begin().

Referenced by blender::tests::TEST().

◆ size()

template<typename T>

int64_t blender::Span< T >::size ( ) const

inlineconstexpr

Returns the number of elements in the referenced array.

Definition at line 252 of file BLI_span.hh.

References size_.

◆ size_in_bytes()

template<typename T>

int64_t blender::Span< T >::size_in_bytes ( ) const

inlineconstexpr

Returns the number of bytes referenced by this Span.

Definition at line 268 of file BLI_span.hh.

References size_, and T.

Referenced by blender::geometry::calculate_uvs(), blender::draw::extract_lines_mesh(), blender::draw::extract_orco(), blender::ed::sculpt_paint::undo::compression::filter_compress(), and blender::tests::TEST().

◆ slice() [1/2]

template<typename T>

Span blender::Span< T >::slice ( IndexRange range ) const

inlineconstexpr

Definition at line 145 of file BLI_span.hh.

References blender::IndexRange::size(), slice(), Span(), and blender::IndexRange::start().

◆ slice() [2/2]

template<typename T>

Span blender::Span< T >::slice	(	int64_t	start,
		int64_t	size ) const

inlineconstexpr

Returns a contiguous part of the array. This invokes undefined behavior when the start or size is negative.

Definition at line 137 of file BLI_span.hh.

References BLI_assert, data_, size(), size_, and Span().

◆ slice_safe() [1/2]

template<typename T>

Span blender::Span< T >::slice_safe	(	const int64_t	start,
		const int64_t	size ) const

inlineconstexpr

Returns a contiguous part of the array. This invokes undefined behavior when the start or size is negative. Clamps the size of the new span so it fits in the current one.

Definition at line 154 of file BLI_span.hh.

References BLI_assert, data_, size(), size_, and Span().

Referenced by animsys_blend_in_fcurves(), blender::io::grease_pencil::GreasePencilExporter::foreach_stroke_in_layer(), slice_safe(), and blender::tests::TEST().

◆ slice_safe() [2/2]

template<typename T>

Span blender::Span< T >::slice_safe ( IndexRange range ) const

inlineconstexpr

Definition at line 162 of file BLI_span.hh.

References blender::IndexRange::size(), slice_safe(), Span(), and blender::IndexRange::start().

◆ take_back()

template<typename T>

Span blender::Span< T >::take_back ( int64_t n ) const

inlineconstexpr

Returns a new Span that only contains the last n elements. This invokes undefined behavior when n is negative.

Definition at line 204 of file BLI_span.hh.

References BLI_assert, data_, size_, and Span().

Referenced by blender::io::usd::calc_curve_offsets(), blender::io::obj::detect_knot_mode_cyclic(), blender::tests::TEST(), and blender::tests::TEST().

◆ take_front()

template<typename T>

Span blender::Span< T >::take_front ( int64_t n ) const

inlineconstexpr

Returns a new Span that only contains the first n elements. This invokes undefined behavior when n is negative.

Definition at line 193 of file BLI_span.hh.

References BLI_assert, data_, size_, and Span().

Referenced by blender::io::usd::calc_curve_offsets(), blender::index_mask::consolidate_index_mask_segments(), blender::bke::node_tree_runtime::find_logical_origins_for_socket_recursive(), blender::index_mask::IndexMask::from_repeating(), blender::nodes::id_property_create_from_socket(), blender::nodes::GeometryNodesLazyFunctionLogger::log_socket_value(), blender::bke::mesh_calc_edges(), blender::nodes::partial_eval::NodeInContextDownstreamComparator::operator()(), blender::nodes::partial_eval::NodeInContextUpstreamComparator::operator()(), blender::index_mask::segments_from_indices(), blender::unique_sorted_indices::split_to_ranges_and_spans(), blender::tests::TEST(), and blender::tests::TEST().

◆ operator!=

template<typename T>

bool operator!=	(	const Span< T >	a,
		const Span< T >	b )

friend

Definition at line 433 of file BLI_span.hh.

References b, and Span().

◆ operator==

template<typename T>

bool operator==	(	const Span< T >	a,
		const Span< T >	b )

friend

Definition at line 425 of file BLI_span.hh.

References b, begin(), end(), size(), and Span().

Member Data Documentation

◆ data_

template<typename T>

const T* blender::Span< T >::data_ = nullptr

protected

Definition at line 85 of file BLI_span.hh.

Referenced by begin(), cast(), data(), drop_back(), drop_front(), end(), first(), first_index_try(), has_duplicates__linear_search(), intersects__linear_search(), last(), operator[](), slice(), slice_safe(), Span(), Span(), Span(), take_back(), and take_front().

◆ size_

template<typename T>

int64_t blender::Span< T >::size_ = 0

protected

Definition at line 86 of file BLI_span.hh.

Referenced by cast(), drop_back(), drop_front(), end(), first(), first_index_try(), has_duplicates__linear_search(), index_range(), intersects__linear_search(), is_empty(), last(), operator[](), size(), size_in_bytes(), slice(), slice_safe(), Span(), Span(), Span(), take_back(), take_front(), blender::VArraySpan< T >::VArraySpan(), and blender::VArraySpan< T >::VArraySpan().

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ const_pointer

◆ const_reference

◆ iterator

◆ pointer

◆ reference

◆ size_type

◆ value_type

Constructor & Destructor Documentation

◆ Span() [1/7]

◆ Span() [2/7]

◆ Span() [3/7]

◆ Span() [4/7]

◆ Span() [5/7]

◆ Span() [6/7]

◆ Span() [7/7]

Member Function Documentation

◆ begin()

◆ cast()

◆ contains()

◆ contains_ptr()

◆ count()

◆ data()

◆ drop_back()

◆ drop_front()

◆ end()

◆ first()

◆ first_index()

◆ first_index_try()

◆ has_duplicates__linear_search()

◆ hash()

◆ index_range()

◆ intersects__linear_search()

◆ is_empty()

◆ last()

◆ operator[]()

◆ rbegin()

◆ rend()

◆ size()

◆ size_in_bytes()

◆ slice() [1/2]

◆ slice() [2/2]

◆ slice_safe() [1/2]

◆ slice_safe() [2/2]

◆ take_back()

◆ take_front()

Friends And Related Symbol Documentation

◆ operator!=

◆ operator==

Member Data Documentation

◆ data_

◆ size_