Asymptote
supports the following data types (in addition to
user-defined types):
void
bool
true
or
false
. For example:
bool b=true;
defines a boolean variable b
and initializes it to the value
true
. If no initializer is given:
bool b;
the value false
is assumed.
bool3
true
, default
, or false
. A bool3 type can be cast
to or from a bool. The default initializer for bool3 is default
.
int
0
is assumed. The minimum allowed value of an integer is intMin
and the
maximum value is intMax
.
real
0.0
. Real numbers have precision
realEpsilon
, with realDigits
significant digits.
The smallest positive real number is realMin
and the largest
positive real number is realMax
.
pair
(x,y)
.
The real and imaginary parts of a pair z
can read as z.x
and z.y
. We say that x
and y
are virtual members of
the data element pair; they cannot be directly modified, however.
The implicit initializer for pairs is (0.0,0.0)
.
There are a number of ways to take the complex conjugate of a pair:
pair z=(3,4); z=(z.x,-z.y); z=z.x-I*z.y; z=conj(z);
Here I
is the pair (0,1)
.
A number of built-in functions are defined for pairs:
pair conj(pair z)
z
;
real length(pair z)
|z|
of its argument z
.
For example,
pair z=(3,4); length(z);
returns the result 5. A synonym for length(pair)
is abs(pair)
;
real angle(pair z, bool warn=true)
z
in radians in the interval
[-pi
,pi
] or 0
if warn
is false
and
z=(0,0)
(rather than producing an error);
real degrees(pair z, bool warn=true)
z
in degrees in the interval [0,360)
or 0
if warn
is false
and z=(0,0)
(rather than
producing an error);
pair unit(pair z)
z
;
pair expi(real angle)
angle
measured in radians;
pair dir(real degrees)
degrees
measured in degrees;
real xpart(pair z)
z.x
;
real ypart(pair z)
z.y
;
pair realmult(pair z, pair w)
(z.x*w.x,z.y*w.y)
;
real dot(pair z, pair w)
z.x*w.x+z.y*w.y
;
pair minbound(pair z, pair w)
(min(z.x,w.x),min(z.y,w.y))
;
pair maxbound(pair z, pair w)
(max(z.x,w.x),max(z.y,w.y))
.
triple
(x,y,z)
used for
three-dimensional drawings. The respective components of a triple
v
can read as v.x
, v.y
, and v.z
.
The implicit initializer for triples is (0.0,0.0,0.0)
.
Here are the built-in functions for triples:
real length(triple v)
|v|
of the vector v
.
A synonym for length(triple)
is abs(triple)
;
real polar(triple v, bool warn=true)
v
measured from the z axis in radians
or 0
if warn
is false
and v=O
(rather than
producing an error);
real azimuth(triple v, bool warn=true)
v
measured from the x axis in radians
or 0
if warn
is false
and v.x=v.y=0
(rather than
producing an error);
real colatitude(triple v, bool warn=true)
v
measured from the z axis in degrees
or 0
if warn
is false
and v=O
(rather than
producing an error);
real latitude(triple v, bool warn=true)
v
measured from the xy plane in degrees
or 0
if warn
is false
and v=O
(rather than
producing an error);
real longitude(triple v, bool warn=true)
v
measured from the x axis in degrees
or 0
if warn
is false
and v.x=v.y=0
(rather than
producing an error);
triple unit(triple v)
v
;
triple expi(real polar, real azimuth)
(polar,azimuth)
measured in radians;
triple dir(real colatitude, real longitude)
(colatitude,longitude)
measured in degrees;
real xpart(triple v)
v.x
;
real ypart(triple v)
v.y
;
real zpart(triple v)
v.z
;
real dot(triple u, triple v)
u.x*v.x+u.y*v.y+u.z*v.z
;
triple cross(triple u, triple v)
(u.y*v.z-u.z*v.y,u.z*v.x-u.x*v.z,u.x*v.y-v.x*u.y)
;
triple minbound(triple u, triple v)
(min(u.x,v.x),min(u.y,v.y),min(u.z,v.z))
;
triple maxbound(triple u, triple v)
(max(u.x,v.x),max(u.y,v.y),max(u.z,v.z)
).
string
string
class.
Strings delimited by double quotes ("
) are subject to the
following mappings to allow the use of double quotes in TeX (e.g. for
using the babel
package, see babel):
Strings delimited by single quotes ('
) have the same mappings as
character strings in ANSI C
:
The implicit initializer for strings is the empty string ""
.
Strings may be concatenated with the +
operator. In the following
string functions, position 0
denotes the start of the string:
int length(string s)
s
;
int find(string s, string t, int pos=0)
t
in string
s
at or after position pos
, or -1 if t
is not a
substring of s
;
int rfind(string s, string t, int pos=-1)
t
in string
s
at or before position pos
(if pos
=-1, at the end
of the string s
), or -1 if t
is not a substring of s
;
string insert(string s, int pos, string t)
t
at position
pos
in s
;
string erase(string s, int pos, int n)
n
(if n
=-1, to the end of the string s
) at
position pos
in s
;
string substr(string s, int pos, int n=-1)
s
starting at position pos
and of length n
(if n
=-1, until the end of the
string s
);
string reverse(string s)
s
;
string replace(string s, string before, string after)
before
in the
string s
changed to the string after
;
string replace(string s, string[][] table)
s
all
occurrences of the string before
in an array table
of
string pairs {before
,after
} to the corresponding
string after
;
string[] split(string s, string delimiter=" ")
s
into substrings
delimited by delimiter
;
string format(string s, int n)
n
formatted according to the C-style
format string s
using the current locale;
string format(string s=defaultformat, real x, string locale="")
x
formatted according to the C-style format
string s
using locale locale
(or the current locale if an
empty string is specified), following the behaviour of the C function
fprintf
), except that only one data field is allowed, trailing
zeros are removed by default (unless #
is specified), and
(if the format string specifies math mode) TeX is used to typeset
scientific notation;
int hex(string s);
s
to an integer.
string string(real x, int digits=realDigits)
x
to a string using precision digits
and the C locale;
string locale(string s="")
string time(string format="%a %b %d %T %Z %Y")
strftime
according to the string format
using the current
locale. Thus
time(); time("%a %b %d %H:%M:%S %Z %Y");
are equivalent ways of returning the current time in the default
format used by the UNIX
date
command;
int seconds(string t="", string format="")
strptime
according to the string format
using the current locale, or the
current time if t
is the empty string.
Note that the "%Z"
extension to the POSIX strptime
specification is ignored by the current GNU C Library. If an error occurs, the
value -1 is returned. Here are some examples:
seconds("Mar 02 11:12:36 AM PST 2007","%b %d %r PST %Y"); seconds(time("%b %d %r %z %Y"),"%b %d %r %z %Y"); seconds(time("%b %d %r %Z %Y"),"%b %d %r "+time("%Z")+" %Y"); 1+(seconds()-seconds("Jan 1","%b %d"))/(24*60*60);The last example returns today's ordinal date, measured from the beginning of the year.
string time(int seconds, string format="%a %b %d %T %Z %Y")
seconds
seconds after the Epoch
(Thu Jan 01 00:00:00 UTC 1970) formatted by the ANSI C routine
strftime
according to the string format
using the current
locale. For example, to return the date corresponding to 24 hours ago:
time(seconds()-24*60*60);
void abort(string s)
s
is nonempty, a diagnostic message constructed from the source
file, line number, and s
is printed;
void exit()
void sleep(int seconds)
void usleep(int microseconds)
void beep()
As in C/C++, complicated types may be abbreviated with typedef
(see the example in Functions).