coth.php 842 B

123456789101112131415161718192021222324252627
  1. <?php
  2. /**
  3. *
  4. * Function code for the complex coth() function
  5. *
  6. * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
  7. * @license https://opensource.org/licenses/MIT MIT
  8. */
  9. namespace Complex;
  10. /**
  11. * Returns the hyperbolic cotangent of a complex number.
  12. *
  13. * @param Complex|mixed $complex Complex number or a numeric value.
  14. * @return Complex The hyperbolic cotangent of the complex argument.
  15. * @throws Exception If argument isn't a valid real or complex number.
  16. * @throws \InvalidArgumentException If function would result in a division by zero
  17. */
  18. if (!function_exists(__NAMESPACE__ . '\\coth')) {
  19. function coth($complex): Complex
  20. {
  21. $complex = Complex::validateComplexArgument($complex);
  22. return inverse(tanh($complex));
  23. }
  24. }