# cpncount

Coupon payments remaining until maturity

## Syntax

## Description

returns
the whole number of coupon payments between the `NumCouponsRemaining`

= cpncount(`Settle`

,`Maturity`

)`Settle`

and `Maturity`

dates
for a coupon bond or set of bonds. Coupons falling on or before `Settle`

are
not counted, except for the `Maturity`

payment
which is always counted.

Required input arguments must be number of bonds, `NUMBONDS`

-by-`1`

or `1`

-by-`NUMBONDS`

,
conforming vectors or scalars.

returns
the whole number of coupon payments between the `NumCouponsRemaining`

= cpncount(___,`Period`

,`Basis`

,`EndMonthRule`

,`IssueDate`

,`FirstCouponDate`

,`LastCouponDate`

)`Settle`

and `Maturity`

dates
for a coupon bond or set of bonds using optional input arguments.

Optional input arguments must be either `NUMBONDS`

-by-`1`

or `1`

-by-`NUMBONDS`

conforming
vectors, scalars, or empty matrices.

## Examples

## Input Arguments

## Output Arguments

## Version History

**Introduced before R2006a**