[#BloombergLP-bdlt-PackedCalendar_HolidayCodeConstIterator]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlt.adoc[bdlt]::PackedCalendar_HolidayCodeConstIterator
:relfileprefix: ../../
:mrdocs:

Provide read‐only, sequential access in increasing (numerical) order to the holiday codes in a `PackedCalendar` object.

== Synopsis

Declared in `<bdlt_packedcalendar.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class PackedCalendar_HolidayCodeConstIterator;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/difference_type.adoc[`difference_type`] 
| Iterator difference type.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/iterator_category.adoc[`iterator_category`] 
| Iterator category for this holiday‐code iterator.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/pointer.adoc[`pointer`] 
| Iterator pointer type.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/reference.adoc[`reference`] 
| The star operator returns an `int` _by_ _value_.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/value_type.adoc[`value_type`] 
| Iterator value type.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/2constructor-02.adoc[`PackedCalendar_HolidayCodeConstIterator`]         [.small]#[constructor]#
| Create an object having the value of the specified `original` iterator.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/2destructor.adoc[`~PackedCalendar_HolidayCodeConstIterator`] [.small]#[destructor]#
| Destroy this object.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/operator_assign.adoc[`operator=`] 
| Assign to this object the value of the specified `rhs` iterator, and return a reference providing modifiable access to this object.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/operator_star.adoc[`operator*`] 
| Return the holiday code referenced by this iterator.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/operator_inc.adoc[`operator++`] 
| Advance this iterator to refer to the next holiday code for the associated date in the associated calendar, and return a reference providing modifiable access to this object. The behavior is undefined unless, on entry, this iterator references a valid holiday code.
| xref:BloombergLP/bdlt/PackedCalendar_HolidayCodeConstIterator/operator_dec.adoc[`operator‐‐`] 
| Regress this iterator to refer to the previous holiday code for the associated date in the associated calendar, and return a reference providing modifiable access to this object. The behavior is undefined unless, on entry, this iterator references a valid holiday code that is not the first holiday code for the associated date in the calendar.
|===


== Friends

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/bdlt/operator_minus-094.adoc[BloombergLP::bdlt::operator‐]`
| Return the number of elements between specified `lhs` and `rhs`. The behavior is undefined unless `lhs` and `rhs` refer to codes associated with the same holiday in the same calendar.
| `xref:BloombergLP/bdlt/operator_not_eq-06b.adoc[BloombergLP::bdlt::operator!=]`
| Return `true` if the specified `lhs` and `rhs` iterators do not refer to the same element, and `false` otherwise. The behavior is undefined unless `lhs` and `rhs` both reference the same holiday in the same calendar.
| `xref:BloombergLP/bdlt/operator_eq-0a4.adoc[BloombergLP::bdlt::operator==]`
| Return `true` if the specified `lhs` and `rhs` iterators refers to the same element, and `false` otherwise. The behavior is undefined unless `lhs` and `rhs` both reference the same holiday in the same calendar.
| `xref:BloombergLP/bdlt/PackedCalendar.adoc[BloombergLP::bdlt::PackedCalendar]`
| This class implements a space‐efficient, value‐semantic repository of weekend and holiday information over a _valid_ _range_ of dates. This valid range, `[firstDate() .. lastDate()]`, spans the first and last dates of a calendar's accessible contents. A calendar can be "populated" with weekend and holiday information via a suite of "add" methods. Any subset of days of the week may be specified as weekend (i.e., recurring non‐business) days starting from a specified date by adding a weekend‐days transition; holidays within the valid range are specified individually. When adding a holiday, an arbitrary integer "holiday code" may be associated with that date. Additional holiday codes for that date may subsequently be added. Both the holidays and the set of unique holiday codes associated with each holiday date are maintained (internally) in order of increasing value. Note that the behavior of requesting _any_ calendar information for a supplied date whose value is outside the current _valid_ _range_ for that calendar (unless otherwise noted, e.g., `isWeekendDay`) is undefined.
|===

== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/operator_inc-0af.adoc[`operator++`]
| Advance the specified `iterator` to refer to the next holiday code for the associated date in the associated calendar, and return the previous value of `iterator`. The behavior is undefined unless, on entry, `iterator` references a valid holiday code.
| xref:BloombergLP/bdlt/operator_dec-02.adoc[`operator‐‐`]
| Regress the specified `iterator` to refer to the previous holiday code for the associated date in the associated calendar, and return the previous value of `iterator`. The behavior is undefined unless, on entry, `iterator` references a valid holiday code that is not the first holiday code for the associated date in the calendar.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#