Loading...
Searching...
No Matches
linePoints Class Reference

Line point storage. Default constructable (line is not). More...

#include <line.H>

Inheritance diagram for linePoints:
Collaboration diagram for linePoints:

Public Member Functions

 linePoints ()=default
 Default construct.
 linePoints (const linePointRef &pts)
 Construct from point references.
 linePoints (const UList< point > &points, const FixedList< label, 2 > &indices)
 Copy construct from subset of points.
const pointa () const noexcept
 The first vertex.
const pointb () const noexcept
 The second vertex.
pointa () noexcept
 The first vertex.
pointb () noexcept
 The second vertex.
linePointRef ln () const
 Return as line reference.
point centre () const
 Return centre (centroid).
scalar mag () const
 The magnitude (length) of the line.
scalar magSqr () const
 The magnitude squared (length squared) of the line.
vector vec () const
 Return start-to-end vector.
vector unitVec () const
 Return the unit vector (start-to-end).
Pair< pointbox () const
 The enclosing (bounding) box for the line.
Public Member Functions inherited from Pair< point >
 Pair ()=default
 Default construct.
void front ()=delete
 The front() accessor (from FixedList) has no purpose.
void back ()=delete
 The back() accessor (from FixedList) has no purpose.
 Pair (const point &f, const point &s)
 Copy construct from components.
 Pair (point &&f, point &&s)
 Move construct from components.
 Pair (const std::pair< point, point > &vals)
 Copy construct from std::pair.
 Pair (std::pair< point, point > &&vals)
 Move construct from std::pair.
 Pair (const FixedList< point, 2 > &list)
 Copy construct FixedList of two items.
 Pair (const point &f, const point &s, const bool doSort)
 Copy construct, optionally sorted with first less-than second.
 Pair (const FixedList< point, 2 > &list, const bool doSort)
 Copy construct, optionally sorted with first less-than second.
 Pair (Istream &is)
 Construct from Istream.
const pointfirst () const noexcept
 Access the first element.
pointfirst () noexcept
 Access the first element.
const pointsecond () const noexcept
 Access the second element.
pointsecond () noexcept
 Access the second element.
const pointother (const point &a) const
 Return other element.
bool is_sorted () const
 True if first() is less-than-equal second().
void flip ()
 Flip the Pair in-place.
void sort ()
 Sort so that first() is less-than second().
Public Member Functions inherited from FixedList< T, N >
 FixedList ()=default
 Default construct.
 FixedList (const T &val)
 Construct and initialize all entries to given value.
 FixedList (Foam::zero)
 Construct and initialize all entries to zero.
 FixedList (const FixedList< T, N > &list)
 Copy construct.
 FixedList (FixedList< T, N > &&list)
 Move construct by using move assignment for the individual list elements.
 FixedList (std::initializer_list< T > list)
 Construct from an initializer list. Runtime size check.
 FixedList (const UList< T > &list)
 Construct from UList. Runtime size check.
template<unsigned AnyNum>
 FixedList (const FixedList< T, AnyNum > &list, const FixedList< label, N > &indices)
 Copy construct from a subset of the input. No size check.
 FixedList (const UList< T > &list, const FixedList< label, N > &indices)
 Copy construct from a subset of the input. No size check.
 FixedList (Istream &is)
 Construct from Istream.
autoPtr< FixedList< T, N > > clone () const
 Clone.
const Tcdata () const noexcept
 Return pointer to the underlying array serving as data storage.
Tdata () noexcept
 Return pointer to the underlying array serving as data storage.
const char * cdata_bytes () const noexcept
 Return pointer to the underlying array serving as data storage,.
char * data_bytes () noexcept
 Return pointer to the underlying array serving as data storage,.
template<unsigned Index>
Tget () noexcept
 Element access using compile-time indexing.
template<unsigned Index>
const Tget () const noexcept
 Element access using compile-time indexing.
Tfront () noexcept
 Access first element of the list, position [0].
const Tfront () const noexcept
 Access first element of the list, position [0].
Tback () noexcept
 Access last element of the list, position [N-1].
const Tback () const noexcept
 Access last element of the list, position [N-1].
label fcIndex (const label i) const noexcept
 Return the forward circular index, i.e. next index which returns to the first at the end of the list.
const TfcValue (const label i) const
 Return forward circular value (ie, next value in the list).
TfcValue (const label i)
 Return forward circular value (ie, next value in the list).
label rcIndex (const label i) const noexcept
 Return the reverse circular index, i.e. previous index which returns to the last at the beginning of the list.
const TrcValue (const label i) const
 Return reverse circular value (ie, previous value in the list).
TrcValue (const label i)
 Return reverse circular value (ie, previous value in the list).
void checkStart (const label start) const
 Check start is within valid range [0,size).
void checkSize (const label size) const
 Check size is identical to template parameter N.
void checkIndex (const label i) const
 Check index is within valid range [0,N).
bool uniform () const
 True if all entries have identical values, and list is non-empty.
bool contains (const T &val) const
 True if the value is contained in the list.
bool contains (const T &val, label pos, label len=-1) const
 Is the value contained in the list?
label find (const T &val) const
 Find index of the first occurrence of the value.
label find (const T &val, label pos, label len=-1) const
 Find index of the first occurrence of the value.
label rfind (const T &val, label pos=-1) const
 Find index of the last occurrence of the value.
void resize (const label n)
 Dummy function, to make FixedList consistent with List Any resizing is ignored (Fatal with bad sizing in full debug).
void resize_fill (const label n, const T &val)
 Set val for all elements. Any resizing is ignored (Fatal with bad sizing in full debug).
void resize_nocopy (const label n)
 Dummy function, to make FixedList consistent with List Any resizing is ignored (Fatal with bad sizing in full debug).
void setSize (const label n)
 Dummy function, to make FixedList consistent with List.
void fill (const T &val)
 Assign all entries to the given value.
void fill (Foam::zero)
 Assign all entries to zero.
void moveFirst (const label i)
 Move element to the first position.
void moveLast (const label i)
 Move element to the last position.
void swapFirst (const label i)
 Swap element with the first element.
void swapLast (const label i)
 Swap element with the last element.
void transfer (FixedList< T, N > &list)
 Transfer by swapping using a move assignment for the content of the individual list elements.
Toperator[] (const label i)
 Return element of FixedList.
const Toperator[] (const label i) const
 Return element of constant FixedList.
void operator= (const UList< T > &list)
 Assignment to UList operator. Takes linear time.
void operator= (std::initializer_list< T > list)
 Assignment to an initializer list. Takes linear time.
void operator= (const T &val)
 Assign all entries to the given value. fill().
void operator= (Foam::zero)
 Assign all entries to zero. fill().
void operator= (const FixedList< T, N > &list)
 Copy assignment.
void operator= (FixedList< T, N > &&list)
 Move assignment.
iterator begin () noexcept
 Return an iterator to begin traversing the FixedList.
iterator end () noexcept
 Return an iterator to end traversing the FixedList.
iterator begin (const int i) noexcept
 Return iterator at offset i from begin, clamped to [0,N] range.
const_iterator cbegin () const noexcept
 Return const_iterator to begin traversing the constant FixedList.
const_iterator cend () const noexcept
 Return const_iterator to end traversing the constant FixedList.
const_iterator begin () const noexcept
 Return const_iterator to begin traversing the constant FixedList.
const_iterator end () const noexcept
 Return const_iterator to end traversing the constant FixedList.
const_iterator cbegin (const int i) const noexcept
 Return const_iterator at offset i from begin, clamped to [0,N] range.
const_iterator begin (const int i) const noexcept
 Return const_iterator at offset i from begin, clamped to [0,N] range.
reverse_iterator rbegin ()
 Return reverse_iterator to begin reverse traversing the FixedList.
reverse_iterator rend ()
 Return reverse_iterator to end reverse traversing the FixedList.
const_reverse_iterator crbegin () const
 Return const_reverse_iterator to begin reverse traversing FixedList.
const_reverse_iterator crend () const
 Return const_reverse_iterator to end reverse traversing FixedList.
const_reverse_iterator rbegin () const
 Return const_reverse_iterator to begin reverse traversing FixedList.
const_reverse_iterator rend () const
 Return const_reverse_iterator to end reverse traversing FixedList.
void swap (FixedList< T, N > &other)
 Swap lists by swapping the content of the individual list elements.
bool operator== (const FixedList< T, N > &list) const
 Equality operation on FixedLists of the same type.
bool operator!= (const FixedList< T, N > &list) const
 The opposite of the equality operation. Takes linear time.
bool operator< (const FixedList< T, N > &list) const
 Compare two FixedLists lexicographically. Takes linear time.
bool operator> (const FixedList< T, N > &list) const
 Compare two FixedLists lexicographically. Takes linear time.
bool operator<= (const FixedList< T, N > &list) const
 Return true if !(a > b). Takes linear time.
bool operator>= (const FixedList< T, N > &list) const
 Return true if !(a < b). Takes linear time.
IstreamreadList (Istream &is)
 Read from Istream, discarding contents of existing List.
void writeEntry (const word &keyword, Ostream &os) const
 Write the list as a dictionary entry with keyword.
OstreamwriteList (Ostream &os, const label shortLen=0) const
 Write List, with line-breaks in ASCII when length exceeds shortLen.
Tfirst () noexcept
 Access first element of the list, position [0] - front().
const Tfirst () const noexcept
 Access first element of the list, position [0] - front().
Tlast () noexcept
 Access last element of the list, position [N-1] - back().
const Tlast () const noexcept
 Access last element of the list, position [N-1] - back().
bool found (const T &val, label pos=0) const
 Same as contains().
 FixedList (const T list[N])
 Deprecated: copy construct from C-array.
void operator= (const T list[N])
 Deprecated: assignment from C-array.

Additional Inherited Members

Public Types inherited from FixedList< T, N >
typedef T value_type
 The value type the FixedList contains.
typedef Tpointer
 The pointer type for non-const access to value_type items.
typedef const Tconst_pointer
 The pointer type for const access to value_type items.
typedef Treference
 The type used for storing into value_type objects.
typedef const Tconst_reference
 The type used for reading from constant value_type objects.
typedef Titerator
 Random access iterator for traversing FixedList.
typedef const Tconst_iterator
 Random access iterator for traversing FixedList.
typedef label size_type
 The type to represent the size of a FixedList.
typedef label difference_type
 The difference between iterator objects.
typedef std::reverse_iterator< iteratorreverse_iterator
 Reverse iterator (non-const access).
typedef std::reverse_iterator< const_iteratorconst_reverse_iterator
 Reverse iterator (const access).
Static Public Member Functions inherited from Pair< point >
static int compare (const Pair< point > &a, const Pair< point > &b)
 Compare Pairs.
Static Public Member Functions inherited from FixedList< T, N >
static const FixedList< T, N > & null () noexcept
 Return a null FixedList (reference to a nullObject). Read/write access is questionable.
static std::streamsize size_bytes () noexcept
 Number of contiguous bytes for the list data,.
static std::streamsize byteSize ()
 Number of contiguous bytes for the list data, runtime FatalError if type is not contiguous.
static constexpr bool empty () noexcept
 Always false since zero-sized FixedList is compile-time disabled.
static constexpr label size () noexcept
 Return the number of elements in the FixedList.
static constexpr unsigned max_size () noexcept
 The dimensioned size (template parameter N) of the FixedList.
Protected Member Functions inherited from FixedList< T, N >
void writeEntry (Ostream &os) const
 Write the FixedList with its compound type.

Detailed Description

Line point storage. Default constructable (line is not).

Definition at line 76 of file line.H.

Constructor & Destructor Documentation

◆ linePoints() [1/3]

linePoints ( )
default

Default construct.

References Pair< point >::Pair(), points, and pts.

Here is the call graph for this function:

◆ linePoints() [2/3]

linePoints ( const linePointRef & pts)
inlineexplicit

Construct from point references.

Definition at line 27 of file lineI.H.

References a(), b(), Pair< point >::Pair(), and pts.

Here is the call graph for this function:

◆ linePoints() [3/3]

linePoints ( const UList< point > & points,
const FixedList< label, 2 > & indices )
inline

Copy construct from subset of points.

Definition at line 33 of file lineI.H.

References FixedList< T, N >::get(), Pair< point >::Pair(), and points.

Here is the call graph for this function:

Member Function Documentation

◆ a() [1/2]

const point & a ( ) const
inlinenoexcept

The first vertex.

Definition at line 117 of file line.H.

References Pair< T >::first(), and Foam::noexcept.

Referenced by box(), centre(), linePoints(), ln(), mag(), magSqr(), unitVec(), and vec().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ b() [1/2]

const point & b ( ) const
inlinenoexcept

The second vertex.

Definition at line 122 of file line.H.

References Foam::noexcept, and Pair< T >::second().

Referenced by linePoints().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ a() [2/2]

point & a ( )
inlinenoexcept

The first vertex.

Definition at line 127 of file line.H.

References Pair< T >::first(), and Foam::noexcept.

Here is the call graph for this function:

◆ b() [2/2]

point & b ( )
inlinenoexcept

The second vertex.

Definition at line 132 of file line.H.

References Foam::noexcept, and Pair< T >::second().

Here is the call graph for this function:

◆ ln()

Foam::linePointRef ln ( ) const
inline

Return as line reference.

Definition at line 76 of file lineI.H.

References a(), and b.

Here is the call graph for this function:

◆ centre()

Foam::point centre ( ) const
inline

Return centre (centroid).

Definition at line 89 of file lineI.H.

References a(), and b.

Here is the call graph for this function:

◆ mag()

Foam::scalar mag ( ) const
inline

The magnitude (length) of the line.

Definition at line 102 of file lineI.H.

References a(), and b.

Here is the call graph for this function:

◆ magSqr()

Foam::scalar magSqr ( ) const
inline

The magnitude squared (length squared) of the line.

Definition at line 115 of file lineI.H.

References a(), and b.

Here is the call graph for this function:

◆ vec()

Foam::vector vec ( ) const
inline

Return start-to-end vector.

Definition at line 128 of file lineI.H.

References a(), and b.

Here is the call graph for this function:

◆ unitVec()

Foam::vector unitVec ( ) const
inline

Return the unit vector (start-to-end).

Definition at line 148 of file lineI.H.

References a(), b, and Foam::normalised().

Here is the call graph for this function:

◆ box()

Foam::Pair< Foam::point > box ( ) const
inline

The enclosing (bounding) box for the line.

Definition at line 172 of file lineI.H.

References a(), b, and line< point, const point & >::box().

Here is the call graph for this function:

The documentation for this class was generated from the following files:
  • src/OpenFOAM/meshes/primitiveShapes/line/line.H
  • src/OpenFOAM/meshes/primitiveShapes/line/lineI.H