PRODUCTS
Products Overview
Mathematica
Mathematica Student Edition
Mathematica Home Edition
Wolfram
CDF Player
(free download)
Computable Document Format (CDF)
web
Mathematica
grid
Mathematica
Wolfram
Workbench
Wolfram
SystemModeler
Wolfram
Finance Platform
Mathematica
Add-Ons
Wolfram|Alpha Products
SOLUTIONS
Solutions Overview
Engineering
Aerospace Engineering & Defense
Chemical Engineering
Control Systems
Electrical Engineering
Image Processing
Industrial Engineering
Materials Science
Mechanical Engineering
Operations Research
Optics
Petroleum Engineering
Biotechnology & Medicine
Bioinformatics
Medical Imaging
Finance, Statistics & Business Analysis
Actuarial Sciences
Data Analysis & Mining
Econometrics
Economics
Financial Engineering & Mathematics
Financial Risk Management
Statistics
Software Engineering & Content Delivery
Authoring & Publishing
Interface Development
Software Engineering
Web Development
Science
Astronomy
Biological Sciences
Chemistry
Environmental Sciences
Geosciences
Social & Behavioral Sciences
Design, Arts & Entertainment
Game Design, Special Effects & Generative Art
Education
STEM Education Initiative
Higher Education
Community & Technical College Education
Primary & Secondary Education
Students
Technology
Computable Document Format (CDF)
High-Performance & Parallel Computing (HPC)
See Also: Technology Guide
PURCHASE
Online Store
Other Ways to Buy
Volume & Site Licensing
Contact Sales
Software
Service
Upgrades
Training
Books
Merchandise
SUPPORT
Support Overview
Mathematica
Documentation
Knowledge Base
Learning Center
Technical Services
Community & Forums
Training
Does My Site Have a License?
Wolfram User Portal
COMPANY
About Wolfram Research
News
Events
Wolfram Blog
Partnerships
Employment Opportunities
History of
Mathematica
Stephen Wolfram's Home Page
Contact Us
OUR SITES
All Sites
Wolfram|Alpha
Demonstrations Project
MathWorld
Integrator
Wolfram Functions Site
Mathematica Journal
Wolfram Media
Wolfram
Tones
Wolfram Science
Stephen Wolfram
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE
DOCUMENTATION CENTER
FOR THE LATEST INFORMATION.
Mathematica
>
Core Language
>
Defining Variables and Functions
>
Assignments
>
Built-in
Mathematica
Symbol
Special Forms of Assignment
Tutorials »
|
Append
PrependTo
Sow
See Also »
|
Assignments
Constructing Lists
Elements of Lists
Procedural Programming
Rearranging & Restructuring Lists
More About »
AppendTo
AppendTo
[
s
,
elem
]
appends
elem
to the value of
s
, and resets
s
to the result.
MORE INFORMATION
AppendTo
[
s
,
elem
]
is equivalent to
s
=
Append
[
s
,
elem
]
.
AppendTo
[
s
,
elem
]
does not evaluate
s
.
You can use
AppendTo
repeatedly to build up a list, though
Sow
and
Reap
will usually be more efficient.
»
AppendTo
works on
SparseArray
objects, returning ordinary lists if necessary.
»
EXAMPLES
CLOSE ALL
Basic Examples
(1)
Assign
l
to a list:
Include a new value at the end of the list:
The value assigned to
l
has changed:
Assign
l
to a list:
In[1]:=
Out[1]=
Include a new value at the end of the list:
In[2]:=
Out[2]=
The value assigned to
l
has changed:
In[3]:=
Out[3]=
Generalizations & Extensions
(2)
Use a head other than
List
:
This assigns
s
to a sparse matrix:
Add a row to the matrix:
Appending an element with inconsistent dimensions requires converting to ordinary lists:
Applications
(1)
Assign
m
to be a 2×2 matrix:
Append a row to
m
:
Append a column to
m
:
m
is now a 3×3 matrix:
Possible Issues
(4)
The first argument must be a variable:
The first argument must be a variable with a value:
The first argument must be assigned to something which can be appended to:
Something for which
AtomQ
is
True
cannot be appended to:
Using
AppendTo
to accumulate values in large loops can be slow:
There are many alternatives, such as using
Reap
and
Sow
:
SEE ALSO
Append
PrependTo
Sow
TUTORIALS
Special Forms of Assignment
MORE ABOUT
Assignments
Constructing Lists
Elements of Lists
Procedural Programming
Rearranging & Restructuring Lists
RELATED LINKS
Demonstrations with AppendTo
(
Wolfram Demonstrations Project
)
New in 1 | Last modified in 5