fill

std/fill.h

• Member Types
• Member Variables
• Member Functions
  • Constructor
  • Utility
  • Iterators
  • Accessors
  • Slicing
  • Modifiers
• Non-Member Functions
  • Comparison
• Examples

---

template <class value_type> struct fill

Stores a counted number of duplicate elements.

Member Types

• typedef value_type type so that generic wrappers can access this containers value_type
• typedef const_iterator iterator so that algorithms dependent upon iterator work.
• fill::<a href="fill-const_iterator>const_iterator

Member Variables

• value_type value represents the value of all of the elements stored.
• int count represents the number of elements this container stores.

Member Functions

Constructor

fill(int count, value_type value) sets count and value directly.

fill(const_iterator left, const_iterator right) where left and right demarcate the bounds of another fill container. This sets count to right-left and value to the value pointed to by left.

Utility

int size() returns the value of count.

Iterators

const_iterator begin() returns an iterator to the first element.

const_iterator end() returns an iterator to one after the last element.

const_iterator rbegin() returns an iterator to the last element.

const_iterator rend() returns an iterator to one before the first element.

const_iterator at(int i) returns an iterator to the ith element.

Accessors

value_type front() returns value.

value_type back() returns value.

value_type get(int i) returns value.

value_type operator[](int i) returns value.

Slicing

slice<fill<value_type> > deref()

wraps this fill with a slice. This is particularly useful if an algorithm gives you a container filled with iterators. You can convert it into a slice with a single call to this function.

fill<int> idx()

If this container is filled with iterators, it returns the index of each iterator.

slice<range<iterator> > sub(int start, int end)
fill<value_type> subcpy(int start, int end)

returns a slice or copy of the elements within the range [start,end).

slice<range<iterator> > sub(int start)
fill<value_type> subcpy(int start)

returns a slice or copy of the elements after start.

slice<range<iterator> > sub()
fill<value_type> subcpy()

returns a slice or copy of all the elements in this container.

static slice<range<const_iterator> > sub(const_iterator start, const_iterator end)

returns a slice of all the elements within the range [start,end) of a fill container.

fill<typename container::iterator> sample(container &c)
fill<typename container::const_iterator> sample(const container &c)

uses the values of the fill container as indices into c. Returns another fill container with the indexed value from c.

Modifiers

void swap(fill<value_type> &root)

swaps the contents of this fill container with another.

fill<value_type> &operator=(const fill<value_type> &root)

sets the contents of this fill container equal the contents of another.

Non-Member Functions

Comparison

bool operator==(fill<value_type1> s1, fill<value_type2> s2)
bool operator!=(fill<value_type1> s1, fill<value_type2> s2)
bool operator<(fill<value_type1> s1, fill<value_type2> s2)
bool operator>(fill<value_type1> s1, fill<value_type2> s2)
bool operator<=(fill<value_type1> s1, fill<value_type2> s2)
bool operator>=(fill<value_type1> s1, fill<value_type2> s2)

Compares two fill containers by comparing value followed by count.

bool operator==(fill<value_type1> s1, core::slice<container2> s2)
bool operator!=(fill<value_type1> s1, core::slice<container2> s2)
bool operator<(fill<value_type1> s1, core::slice<container2> s2)
bool operator>(fill<value_type1> s1, core::slice<container2> s2)
bool operator<=(fill<value_type1> s1, core::slice<container2> s2)
bool operator>=(fill<value_type1> s1, core::slice<container2> s2)
bool operator==(core::slice<container1> s1, fill<value_type2> s2)
bool operator!=(core::slice<container1> s1, fill<value_type2> s2)
bool operator<(core::slice<container1> s1, fill<value_type2> s2)
bool operator>(core::slice<container1> s1, fill<value_type2> s2)
bool operator<=(core::slice<container1> s1, fill<value_type2> s2)
bool operator>=(core::slice<container1> s1, fill<value_type2> s2)

Compares a fill container to a generic slice by calling compare().

Examples

#include <std/ascii_stream.h>
#include <std/fill.h>

using namespace core;

int main()
{
    fill<int> f(10, 5);
    cout << f << endl;
    return 0;
}

{5, 5, 5, 5, 5, 5, 5, 5, 5, 5}