atanh.php 1.1 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. <?php
  2. /**
  3. *
  4. * Function code for the complex atanh() 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 inverse hyperbolic tangent of a complex number.
  12. *
  13. * @param Complex|mixed $complex Complex number or a numeric value.
  14. * @return Complex The inverse hyperbolic tangent of the complex argument.
  15. * @throws Exception If argument isn't a valid real or complex number.
  16. */
  17. function atanh($complex)
  18. {
  19. $complex = Complex::validateComplexArgument($complex);
  20. if ($complex->isReal()) {
  21. $real = $complex->getReal();
  22. if ($real >= -1.0 && $real <= 1.0) {
  23. return new Complex(\atanh($real));
  24. } else {
  25. return new Complex(\atanh(1 / $real), (($real < 0.0) ? M_PI_2 : -1 * M_PI_2));
  26. }
  27. }
  28. $iComplex = clone $complex;
  29. $iComplex = $iComplex->invertImaginary()
  30. ->reverse();
  31. return atan($iComplex)
  32. ->invertReal()
  33. ->reverse();
  34. }