From ba611ac7728b23b60888568c30110fc2a7b0d6d1 Mon Sep 17 00:00:00 2001
From: Ayushi Negi <ayushin78@users.noreply.github.com>
Date: Sun, 3 Jul 2016 08:55:16 +0530
Subject: [PATCH] Create Python-Function-Complex.md (#1206)

* Create Python-Function-Complex.md

For issue #819

* Update Python-Function-Complex.md

* Update Python-Function-Complex.md

* Update Python-Function-Complex.md
---
 Python-Function-Complex.md | 54 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 Python-Function-Complex.md

diff --git a/Python-Function-Complex.md b/Python-Function-Complex.md
new file mode 100644
index 000000000..5db332fd9
--- /dev/null
+++ b/Python-Function-Complex.md
@@ -0,0 +1,54 @@
+# Python Complex()
+
+`complex()` is a built-in function in Python 3 that hanldles the creation of a [complex number](https://www.mathsisfun.com/numbers/complex-numbers.html) according to the arguments passed. It returns a complex number with the value `real + imag*1j` when called in form of `complex(real, imag)` or converts a string or number to a complex number.
+
+## Arguments and Return Values
+
+This function takes two types of arguments which are discussed below :
+
+#### Numeric Arguments
+
+When called with two arguments, both being numbers of any numeric type (including complex), this function returns a complex number using both arguments.
+`complex(x, y)` function returns a complex number with the value `x + y*1j`
+
+```python
+>>> complex(3, 2)
+(3+2j)
+>>> complex(3+4j, 6)
+(3+10j)
+```
+When called with one numeric argument, it returns a complex number using  the argument as the real part and an imaginary part of zero.
+
+```python
+>>> complex(4)
+(4+0j)
+```
+If called with no arguments, it returns a complex zero.
+
+```python
+>>> complex()
+0j
+```
+#### String Argument
+
+If the first argument is a string, it will be interpreted as a *complex number* and the function must be called without a second parameter. It will return the interpreted  complex number.
+
+```python
+>>> complex('3+4j')
+(3+4j)
+```
+The string must be in the form of a valid complex number, otherwise the function will raise a `ValueError` exception and it must not contain whitespace around the central + or - operator. For example, `complex('1+2j')` is fine, but `complex('1 + 2j')` raises `ValueError`.
+
+## Examples
+
+```python
+print(complex(4, 5))      # prints (4+5j)
+print(complex(6))         # prints (6+0j)
+print(complex())          # prints 0j
+print(complex(2.5,5))     # prints (2.5+5j)
+print(complex(5,6+8j))    # prints (-3+6j) as 5+(6+8j)*1j = -3+6j
+print(complex('10+20j'))  # prints (10+20j)
+```
+:rocket: [Run Code](https://repl.it/CTGi/3)
+
+[Official Documentation](https://docs.python.org/3/library/functions.html#complex)