NAME
    str - convert some types of values to strings

SYNOPSIS
    str(x)

TYPES
    x		null, string, real or complex number

    return	string

DESCRIPTION
    Convert a value into a string.

    If x is null, str(x) returns the string "".

    If x is a string, str(x) returns x.

    For real or complex x, str(x) returns the string representing x
    in the current printing mode; configuration parameters affecting
    this are "mode", "mode2", "display", "outround", "tilde", "leadzero",

EXAMPLE
    ; str("")
	    ""
    ; str(null())
	    ""
    ; print str(123), str("+"), str(4i), str("is the same as"), str(123+4i)
    123 + 4i is the same as 3+4i

    ; base2(16),
    ; print str(23209)
    23209 /* 0x5aa9 */

LIMITS
    none

LINK LIBRARY
    void math_divertio();
    qprintnum(NUMBER *x, int outmode);
    char *math_getdivertedio();

    math_divertio();
    comprint(COMPLEX *x);
    char *math_getdivertedio();

SEE ALSO
    base, base2, config

## Copyright (C) 1999-2006  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
##
## @(#) $Revision: 30.1 $
## @(#) $Id: str,v 30.1 2007/03/16 11:10:42 chongo Exp $
## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/str,v $
##
## Under source code control:	1995/10/05 04:52:27
## File existed as early as:	1995
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/
