added an example
added return values and an example