// bbldc_basicbasicdaycountadapter.h -*-C++-*- #ifndef INCLUDED_BBLDC_BASICBASICDAYCOUNTADAPTER #define INCLUDED_BBLDC_BASICBASICDAYCOUNTADAPTER #include <bsls_ident.h> BSLS_IDENT("$Id: $") //@PURPOSE: Provide a parameterized day-count convention implementation. // //@CLASSES: // bbldc::BasicBasicDayCountAdapter: 'bbldc::BasicDayCount' realization // //@DESCRIPTION: This component provides a parameterized (template) // implementation, 'bbldc::BasicBasicDayCountAdapter', of the // 'bbldc::BasicDayCount' protocol. The template argument can be any type // supporting the following two class methods. //.. // int daysDiff(const bdlt::Date& beginDate, const bdlt::Date& endDate); // // double yearsDiff(const bdlt::Date& beginDate, const bdlt::Date& endDate); //.. // The template class 'bbldc::BasicBasicDayCountAdapter' provides convenient // support for run-time polymorphic choice of day-count conventions (via // conventional use of a base-class pointer or reference) without having to // implement each derived type explicitly. In this sense, // 'bbldc::BasicBasicDayCountAdapter' adapts the various concrete "basic" // day-count convention classes (e.g., 'bbldc::BasicIsma30360') to a run-time // binding mechanism. // ///Usage ///----- // This section illustrates intended use of this component. // ///Example 1: Adapting 'bbldc::BasicIsma30360' ///- - - - - - - - - - - - - - - - - - - - - - // This example shows the procedure for using // 'bbldc::BasicBasicDayCountAdapter' to adapt the 'bbldc::BasicIsma30360' // day-count convention to the 'bbldc::BasicDayCount' protocol, and then the // use of the day-count methods. First, we define an instance of the adapted // day-count convention and obtain a reference to the 'bbldc::BasicDayCount': //.. // const bbldc::BasicBasicDayCountAdapter<bbldc::BasicIsma30360> myDcc = // bbldc::BasicBasicDayCountAdapter<bbldc::BasicIsma30360>(); // const bbldc::BasicDayCount& dcc = myDcc; //.. // Then, create two 'bdlt::Date' variables, 'd1' and 'd2', with which to use // the day-count convention methods: //.. // const bdlt::Date d1(2003, 10, 18); // const bdlt::Date d2(2003, 12, 31); //.. // Now, use the base-class reference to compute the day count between the two // dates: //.. // const int daysDiff = dcc.daysDiff(d1, d2); // assert(72 == daysDiff); //.. // Finally, use the base-class reference to compute the year fraction between // the two dates: //.. // const double yearsDiff = dcc.yearsDiff(d1, d2); // // Need fuzzy comparison since 'yearsDiff' is a 'double'. // assert(0.1999 < yearsDiff && 0.2001 > yearsDiff); //.. #include <bblscm_version.h> #include <bbldc_basicdaycount.h> #include <bdlt_date.h> namespace BloombergLP { namespace bbldc { // =============================== // class BasicBasicDayCountAdapter // =============================== template <class CONVENTION> class BasicBasicDayCountAdapter : public BasicDayCount { // This 'class' provides an "adapter" from the specified 'CONVENTION' to // the 'bbldc::BasicDayCount' protocol that can be used for determining // values based on dates according to the day-count 'CONVENTION'. public: // ACCESSORS int daysDiff(const bdlt::Date& beginDate, const bdlt::Date& endDate) const; // Return the (signed) number of days between the specified 'beginDate' // and 'endDate' as per the 'CONVENTION' template policy. If // 'beginDate <= endDate', then the result is non-negative. Note that // reversing the order of 'beginDate' and 'endDate' negates the result. double yearsDiff(const bdlt::Date& beginDate, const bdlt::Date& endDate) const; // Return the (signed fractional) number of years between the specified // 'beginDate' and 'endDate' as per the 'CONVENTION' template policy. // If 'beginDate <= endDate', then the result is non-negative. Note // that reversing the order of 'beginDate' and 'endDate' negates the // result; specifically, // '|yearsDiff(b, e) + yearsDiff(e, b)| <= 1.0e-15' for all dates 'b' // and 'e'. }; // ============================================================================ // INLINE DEFINITIONS // ============================================================================ // ------------------------------- // class BasicBasicDayCountAdapter // ------------------------------- // ACCESSORS template <class CONVENTION> inline int BasicBasicDayCountAdapter<CONVENTION>::daysDiff( const bdlt::Date& beginDate, const bdlt::Date& endDate) const { return CONVENTION::daysDiff(beginDate, endDate); } template <class CONVENTION> inline double BasicBasicDayCountAdapter<CONVENTION>::yearsDiff( const bdlt::Date& beginDate, const bdlt::Date& endDate) const { return CONVENTION::yearsDiff(beginDate, endDate); } } // close package namespace } // close enterprise namespace #endif // ---------------------------------------------------------------------------- // Copyright 2015 Bloomberg Finance L.P. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // ----------------------------- END-OF-FILE ----------------------------------