1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html>
3<!-- This file documents the GNU Assembler "as".
4
5Copyright (C) 1991-2021 Free Software Foundation, Inc.
6
7Permission is granted to copy, distribute and/or modify this document
8under the terms of the GNU Free Documentation License, Version 1.3
9or any later version published by the Free Software Foundation;
10with no Invariant Sections, with no Front-Cover Texts, and with no
11Back-Cover Texts.  A copy of the license is included in the
12section entitled "GNU Free Documentation License".
13 -->
14<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
15<head>
16<title>Using as: Set</title>
17
18<meta name="description" content="Using as: Set">
19<meta name="keywords" content="Using as: Set">
20<meta name="resource-type" content="document">
21<meta name="distribution" content="global">
22<meta name="Generator" content="makeinfo">
23<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
24<link href="index.html#Top" rel="start" title="Top">
25<link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
26<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
27<link href="Pseudo-Ops.html#Pseudo-Ops" rel="up" title="Pseudo Ops">
28<link href="Short.html#Short" rel="next" title="Short">
29<link href="Section.html#Section" rel="previous" title="Section">
30<style type="text/css">
31<!--
32a.summary-letter {text-decoration: none}
33blockquote.smallquotation {font-size: smaller}
34div.display {margin-left: 3.2em}
35div.example {margin-left: 3.2em}
36div.indentedblock {margin-left: 3.2em}
37div.lisp {margin-left: 3.2em}
38div.smalldisplay {margin-left: 3.2em}
39div.smallexample {margin-left: 3.2em}
40div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
41div.smalllisp {margin-left: 3.2em}
42kbd {font-style:oblique}
43pre.display {font-family: inherit}
44pre.format {font-family: inherit}
45pre.menu-comment {font-family: serif}
46pre.menu-preformatted {font-family: serif}
47pre.smalldisplay {font-family: inherit; font-size: smaller}
48pre.smallexample {font-size: smaller}
49pre.smallformat {font-family: inherit; font-size: smaller}
50pre.smalllisp {font-size: smaller}
51span.nocodebreak {white-space:nowrap}
52span.nolinebreak {white-space:nowrap}
53span.roman {font-family:serif; font-weight:normal}
54span.sansserif {font-family:sans-serif; font-weight:normal}
55ul.no-bullet {list-style: none}
56-->
57</style>
58
59
60</head>
61
62<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
63<a name="Set"></a>
64<div class="header">
65<p>
66Next: <a href="Short.html#Short" accesskey="n" rel="next">Short</a>, Previous: <a href="Section.html#Section" accesskey="p" rel="previous">Section</a>, Up: <a href="Pseudo-Ops.html#Pseudo-Ops" accesskey="u" rel="up">Pseudo Ops</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
67</div>
68<hr>
69<a name="g_t_002eset-symbol_002c-expression"></a>
70<h3 class="section">7.85 <code>.set <var>symbol</var>, <var>expression</var></code></h3>
71
72<a name="index-set-directive"></a>
73<a name="index-symbol-value_002c-setting"></a>
74<p>Set the value of <var>symbol</var> to <var>expression</var>.  This
75changes <var>symbol</var>&rsquo;s value and type to conform to
76<var>expression</var>.  If <var>symbol</var> was flagged as external, it remains
77flagged (see <a href="Symbol-Attributes.html#Symbol-Attributes">Symbol Attributes</a>).
78</p>
79<p>You may <code>.set</code> a symbol many times in the same assembly provided that the
80values given to the symbol are constants.  Values that are based on expressions
81involving other symbols are allowed, but some targets may restrict this to only
82being done once per assembly.  This is because those targets do not set the
83addresses of symbols at assembly time, but rather delay the assignment until a
84final link is performed.  This allows the linker a chance to change the code in
85the files, changing the location of, and the relative distance between, various
86different symbols.
87</p>
88<p>If you <code>.set</code> a global symbol, the value stored in the object
89file is the last value stored into it.
90</p>
91<p>On Z80 <code>set</code> is a real instruction, use <code>.set</code> or
92&lsquo;<samp><var>symbol</var> defl <var>expression</var></samp>&rsquo; instead.
93</p>
94
95
96
97</body>
98</html>
99