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.

Synopsis

Declared in <bdlt_packedcalendar.h>

class PackedCalendar;

Type Aliases

NameDescription
BusinessDayConstIterator Constant iterator over business days in this calendar.
BusinessDayConstReverseIterator Constant reverse iterator over business days in this calendar.
HolidayCodeConstIterator Constant iterator over holiday codes in this calendar.
HolidayCodeConstReverseIterator Constant reverse iterator over holiday codes in this calendar.
HolidayConstIterator Constant iterator over holidays in this calendar.
HolidayConstReverseIterator Constant reverse iterator over holidays in this calendar.
WeekendDaysTransition Transition describing a change in weekend days.
WeekendDaysTransitionConstIterator Constant iterator over weekend-days transitions in this calendar.
WeekendDaysTransitionConstReverseIterator Constant reverse iterator over weekend-days transitions in this calendar.

Member Functions

NameDescription
PackedCalendar [constructor]Constructors
~PackedCalendar [destructor]Destroy this object.
operator= Assign to this calendar the value of the specified rhs calendar, and return a reference providing modifiable access to this calendar. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
addDay Extend the valid range (if necessary) of this calendar to include the specified date value.
addHoliday Mark the specified date as a holiday (i.e., a non-business day) in this calendar. Extend the valid range of this calendar if necessary. If date is already marked as a holiday, this method has no effect. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
addHolidayCode Mark the specified date as a holiday (i.e., a non-business day) in this calendar and add the specified holidayCode (if not already present) to the ordered set of codes associated with date. Extend the valid range of this calendar if necessary. If holidayCode is already a code for date, this method has no effect. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
addHolidayCodeIfInRange Mark the specified date as a holiday (i.e., a non-business day) in this calendar and add the specified holidayCode (if not already present) to the set of codes associated with date, if date is within the valid range of this calendar. Return 0 if date is in range, and a non-zero value otherwise. If holidayCode is already a code for date, or if date is not in the valid range, this method has no effect. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. Note that this method may be called repeatedly with the same value for date to build up a set of holiday codes for that date.
addHolidayIfInRange Mark the specified date as a holiday (i.e., a non-business day) in this calendar if date is within the valid range. Return 0 if date is in range, and a non-zero value otherwise. This method has no effect if date is already marked as a holiday or is not in the valid range. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
addWeekendDay Add the specified weekendDay to the set of weekend days associated with the weekend-days transition at January 1, 0001 maintained by this calendar. Create a transition at January 1, 0001 if one does not exist. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. The behavior is undefined unless no weekend-days transitions were added to this calendar via the addWeekendDaysTransition method.
addWeekendDays Add the specified weekendDays to the set of weekend days associated with the weekend-days transition at January 1, 0001 maintained by this calendar. Create a transition at January 1, 0001 if one does not exist. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. The behavior is undefined unless no weekend-days transitions were added to this calendar via the addWeekendDaysTransition method.
addWeekendDaysTransition Add to this calendar a weekend-days transition on the specified startDate having the specified weekendDays set. If a weekend-days transition already exists on startDate, replace the set of weekend days of that transition with weekendDays. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. Note that this method does not extend the valid range of the calendar.
allocator Return the allocator used by this object to supply memory.
bdexStreamIn Assign to this object the value read from the specified input stream using the specified version format and return a reference to the modifiable stream. If stream is initially invalid, this operation has no effect. If stream becomes invalid during this operation or if version is not supported, this object is unaltered. Note that no version is read from stream. See the bslx package-level documentation for more information on BDEX streaming of value-semantic types and containers.
bdexStreamOut Write this value to the specified output stream using the specified version format and return a reference to the modifiable stream. If version is not supported, stream is unmodified. Note that version is not written to stream. See the bslx package-level documentation for more information on BDEX streaming of value-semantic types and containers.
beginBusinessDays beginBusinessDays overloads
beginHolidayCodes beginHolidayCodes overloads
beginHolidays beginHolidays overloads
beginWeekendDaysTransitions Return an iterator providing non-modifiable access to the first weekend-days transition in the chronological sequence of weekend-days transitions maintained by this calendar. If this calendar has no weekend-days transitions, the returned iterator has the same value as that returned by endWeekendDaysTransitions().
endBusinessDays endBusinessDays overloads
endHolidayCodes endHolidayCodes overloads
endHolidays endHolidays overloads
endWeekendDaysTransitions Return an iterator providing non-modifiable access to the past-the-end weekend-days transition in the chronological sequence of weekend-days transitions maintained by this calendar.
firstDate Return a reference providing non-modifiable access to the earliest date in the valid range of this calendar. The behavior is undefined unless this calendar is non-empty -- i.e., unless 1 <= length().
getNextBusinessDay getNextBusinessDay overloads
holiday Return the holiday at the specified index in this calendar. For all index values from 0 to numHolidays() - 1 (inclusive), a unique holiday is returned. The mapping of index to holiday is invalidated when the set of holidays is modified by an invocation of addHoliday, addHolidayIfInRange, intersectBusinessDays, intersectNonBusinessDays, removeAll, removeHoliday, setValidRange, unionBusinessDays, or unionNonBusinessDays. The behavior is undefined unless 0 <= index < numHolidays().
holidayCode Return, for the holiday at the specified date in this calendar, the holiday code at the specified index. For all index values from 0 to numHolidayCodes(date) - 1 (inclusive), a unique holiday code is returned. The mapping of index to holiday code is invalidated when the set of holidays or holiday codes is modified by an invocation of addHoliday, addHolidayCode, addHolidayCodeIfInRange, addHolidayIfInRange, intersectBusinessDays, intersectNonBusinessDays, removeAll, removeHoliday, removeHolidayCode, setValidRange, unionBusinessDays, or unionNonBusinessDays. The behavior is undefined unless date is a holiday in this calendar and 0 <= index < numHolidayCodes(date). Note that this method facilitates testing and generally should not be used by clients; in particular, using this method to iterate over the holiday codes for date is less efficient than using a HolidayCodeConstIterator.
intersectBusinessDays Merge the specified other calendar into this calendar such that the valid range of this calendar becomes the intersection of the two calendars' ranges, and the weekend days and holidays for this calendar become the union of those (non-business) days from the two calendars -- i.e., the valid business days of this calendar become the intersection of those of the two original calendar values over the intersection of their ranges. For each holiday that remains, the resulting holiday codes in this calendar will be the union of the corresponding original holiday codes. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
intersectNonBusinessDays Merge the specified other calendar into this calendar such that the valid range of this calendar becomes the intersection of the two calendars' ranges, the weekend days for this calendar become the intersection of those days from the two calendars, and the holidays for this calendar become the set of days that are a holiday in one of the calendars and a non-business day in the other calendar -- i.e., the valid business days of this calendar become the union of those of the two original calendars over the intersection of their ranges. For each holiday that remains, the resulting holiday codes in this calendar will be the union of the corresponding original holiday codes. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
isBusinessDay Return true if the specified date is a business day (i.e., not a holiday or weekend day) in this calendar, and false otherwise. The behavior is undefined unless date is within the valid range of this calendar.
isHoliday Return true if the specified date is a holiday in this calendar, and false otherwise. The behavior is undefined unless date is within the valid range of this calendar.
isInRange Return true if the specified date is within the valid range of this calendar (i.e., firstDate() <= date <= lastDate()), and false otherwise. Note that the valid range for a PackedCalendar is empty if its length is 0.
isNonBusinessDay Return true if the specified date is not a business day (i.e., is either a holiday or weekend day) in this calendar, and false otherwise. The behavior is undefined unless date is within the valid range of this calendar. Note that: ` !isBusinessDay(date) ` returns the same result.
isWeekendDay isWeekendDay overloads
lastDate Return a reference providing non-modifiable access to the latest date in the valid range of this calendar. The behavior is undefined unless this calendar is non-empty -- i.e., unless 1 <= length().
length Return the number of days in the valid range of this calendar, which is defined to be 0 if this calendar is empty, and lastDate() - firstDate() + 1 otherwise.
numBusinessDays numBusinessDays overloads
numHolidayCodes Return the number of (unique) holiday codes associated with the specified date in this calendar if date is a holiday in this calendar, and 0 otherwise. The behavior is undefined unless date is within the valid range of this calendar.
numHolidayCodesTotal Return the total number of holiday codes for all holidays in this calendar. Note that this function is used primarily in conjunction with reserveHolidayCodeCapacity.
numHolidays Return the number of days in the valid range of this calendar that are individually marked as holidays, irrespective of whether or not the date is also considered a weekend day.
numNonBusinessDays Return the number of days in the valid range of this calendar that are not considered business days -- i.e., are either holidays, weekend days, or both. Note that numNonBusinessDays() == length() - numBusinessDays().
numWeekendDaysInRange Return the number of days in the valid range of this calendar that are considered weekend days, irrespective of any designated holidays.
numWeekendDaysTransitions Return the number of weekend-days transitions maintained by this calendar.
print Format this object to the specified output stream at the (absolute value of) the optionally specified indentation level and return a reference to the modifiable stream. If level is specified, optionally specify spacesPerLevel, the number of spaces per indentation level for this and all of its nested objects. If level is negative, suppress indentation of the first line. If spacesPerLevel is negative, format the entire output on one line, suppressing all but the initial indentation (as governed by level). If stream is not valid on entry, this operation has no effect.
rbeginBusinessDays rbeginBusinessDays overloads
rbeginHolidayCodes rbeginHolidayCodes overloads
rbeginHolidays rbeginHolidays overloads
rbeginWeekendDaysTransitions Return an iterator providing non-modifiable access to the last weekend-days transition in the chronological sequence of weekend-days transitions maintained by this calendar. If this calendar has no weekend-days transitions, the returned iterator has the same value as that returned by rendWeekendDaysTransitions().
removeAll Remove all information from this calendar, leaving it with its default constructed "empty" value. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
removeHoliday Remove from this calendar the holiday having the specified date if such a holiday exists. This operation has no effect if date is not a holiday in this calendar. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. Note that this method is defined for all date values, not just those that fall within the valid range, and may be invoked even on an empty calendar (i.e., having 0 == length()).
removeHolidayCode Remove from this calendar the specified holidayCode for the holiday having the specified date if such a holiday having holidayCode exists. This operation has no effect if date is not a holiday in this calendar, or if the holiday at date does not have holidayCode associated with it. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. Note that this method is defined for all date values, not just those that fall within the valid range, and may be invoked even on an empty calendar (i.e., having 0 == length()).
rendBusinessDays rendBusinessDays overloads
rendHolidayCodes rendHolidayCodes overloads
rendHolidays rendHolidays overloads
rendWeekendDaysTransitions Return an iterator providing non-modifiable access to the element one before the first weekend-days transition in the chronological sequence of weekend-days transitions maintained by this calendar.
reserveHolidayCapacity Reserve enough space to store at least the specified numHolidays within this calendar. This method has no effect if numHolidays <= numHolidays().
reserveHolidayCodeCapacity Reserve enough space to store at least the specified numHolidayCodes within this calendar assuming no additional holidays are added to this calendar. This method has no effect if numHolidayCodes <= numHolidayCodesTotal().
setValidRange Set the range of this calendar using the specified firstDate and lastDate as, respectively, the first date and the last date of the calendar. Any holiday that is outside the new range and its holiday codes are removed. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method. The behavior is undefined unless firstDate <= lastDate.
swap Efficiently exchange the value of this object with the value of the specified other object. This method provides the no-throw exception-safety guarantee. The behavior is undefined unless this object was created with the same allocator as other.
unionBusinessDays Merge the specified other calendar into this calendar such that the valid range of this calendar becomes the union of the two calendars' ranges (or the minimal continuous range spanning the two ranges, if the ranges are non-overlapping), the weekend days for this calendar become the intersection of those days from the two calendars, and the holidays for this calendar become the set of days that are a holiday in one of the calendars and a non-business day in the other calendar -- i.e., the valid business days of this calendar become the union of those of the two original calendar values. For each holiday that remains, the resulting holiday codes in this calendar will be the union of the corresponding original holiday codes. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
unionNonBusinessDays Merge the specified other calendar into this calendar such that the valid range of this calendar becomes the union of the two calendars' ranges (or the minimal continuous range spanning the two ranges, if the ranges are non-overlapping), and the weekend days and holidays for this calendar become the union of those (non-business) days from the two calendars -- i.e., the valid business days of this calendar become the intersection of those of the two calendars after each range is extended to cover the resulting one. For each holiday in either calendar, the resulting holiday codes in this calendar will be the union of the corresponding original holiday codes. See {Iterator Invalidation} for information regarding which iterators are affected by the use of this method.
weekendDaysTransition Return the weekend-days transition at the specified index in this calendar. For all index values from 0 to numWeekendDaysTransitions() - 1 (inclusive), a unique weekend-days transition is returned. The mapping of index to weekend-days transition is invalidated when the set of weekend-days transitions is modified by an invocation of addWeekendDay, addWeekendDays, addWeekendDaysTransition, intersectBusinessDays, intersectNonBusinessDays, removeAll, unionBusinessDays, or unionNonBusinessDays. The behavior is undefined unless 0 <= index < numWeekendDaysTransitions().

Static Member Functions

NameDescription
maxSupportedBdexVersion maxSupportedBdexVersion overloads

Friends

NameDescription
BloombergLP::bdlt::hashAppendPass the specified object to the specified hashAlg. This function integrates with the bslh modular hashing system and effectively provides a bsl::hash specialization for PackedCalendar.
BloombergLP::bdlt::operator!=Return true if the specified lhs and rhs calendars do not have the same value, and false otherwise. Two calendars do not have the same value if they do not have the same valid range (and are not both empty), do not have the same weekend days, do not have the same holidays, or, for at least one corresponding pair of holidays, do not have the same (ordered) set of associated holiday codes.
BloombergLP::bdlt::operator==Return true if the specified lhs and rhs calendars have the same value, and false otherwise. Two calendars have the same value if they have the same valid range (or are both empty), the same weekend days, the same holidays, and each corresponding pair of holidays has the same (ordered) set of associated holiday codes.
BloombergLP::bdlt::PackedCalendar_BusinessDayConstIteratorProvide read-only, sequential access in increasing (chronological) order to the business days in a PackedCalendar object.

Non-Member Functions

NameDescription
swapExchange the values of the specified a and b objects. This function provides the no-throw exception-safety guarantee if the two objects were created with the same allocator and the basic guarantee otherwise.