Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::ratio_subtract(3)	      C++ Standard Libary	std::ratio_subtract(3)

NAME
       std::ratio_subtract - std::ratio_subtract

Synopsis
	  Defined in header <ratio>
	  template< class R1, class R2 >	   (since C++11)
	  using	ratio_subtract = /* see	below */;

	  The  alias  template	std::ratio_subtract denotes the	result of sub-
       tracting	two exact
	  rational fractions represented by the	std::ratio specializations  R1
       and R2.

	  The  result  is  a  std::ratio specialization	std::ratio<U, V>, such
       that given Num ==
	  R1::num * R2::den - R2::num *	R1::den	and Denom == R1::den * R2::den
       (computed
	  without arithmetic overflow),	U is std::ratio<Num, Denom>::num and V
       is
	  std::ratio<Num, Denom>::den.

Notes
	  If U or V is not representable in std::intmax_t, the program is ill-
       formed. If Num
	  or Denom is not representable	in std::intmax_t, the program is  ill-
       formed unless the
	  implementation yields	correct	values for U and V.

	  The  above  definition  requires  that the result of std::ratio_sub-
       tract<R1, R2> be
	  already  reduced  to	lowest	terms;	for  example,  std::ratio_sub-
       tract<std::ratio<1, 2>,
	  std::ratio<1,	6>> is the same	type as	std::ratio<1, 3>.

Example
       // Run this code

	#include <iostream>
	#include <ratio>

	int main()
	{
	    using two_third = std::ratio<2, 3>;
	    using one_sixth = std::ratio<1, 6>;

	    using diff = std::ratio_subtract<two_third,	one_sixth>;
	    std::cout  <<  "2/3	 - 1/6 = " << diff::num	<< '/' << diff::den <<
       '\n';
	}

Output:
	2/3 - 1/6 = 1/2

http://cppreference.com		  2022.07.31		std::ratio_subtract(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::ratio_subtract&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help