source: public/doc/gnu-c/Aliasing.html@ 02598c2

Last change on this file since 02598c2 was 02598c2, checked in by Mikhail Kirillov <w96k@…>, on Oct 6, 2022 at 12:36:29 PM

Add gnu-c

  • Property mode set to 100644
File size: 5.1 KB
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html>
3<!-- Copyright (C) 2022 Richard Stallman and Free Software Foundation, Inc.
4
5(The work of Trevis Rothwell and Nelson Beebe has been assigned or
6licensed to the FSF.)
7
8Permission is granted to copy, distribute and/or modify this document
9under the terms of the GNU Free Documentation License, Version 1.3 or
10any later version published by the Free Software Foundation; with the
11Invariant Sections being "GNU General Public License," with the
12Front-Cover Texts being "A GNU Manual," and with the Back-Cover
13Texts as in (a) below. A copy of the license is included in the
14section entitled "GNU Free Documentation License."
15
16(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
17modify this GNU manual. Buying copies from the FSF supports it in
18developing GNU and promoting software freedom." -->
19<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
20<head>
21<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
22<title>Aliasing (GNU C Language Manual)</title>
23
24<meta name="description" content="Aliasing (GNU C Language Manual)">
25<meta name="keywords" content="Aliasing (GNU C Language Manual)">
26<meta name="resource-type" content="document">
27<meta name="distribution" content="global">
28<meta name="Generator" content="makeinfo">
29<link href="index.html" rel="start" title="Top">
30<link href="Symbol-Index.html" rel="index" title="Symbol Index">
31<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
32<link href="index.html" rel="up" title="Top">
33<link href="Aliasing-Alignment.html" rel="next" title="Aliasing Alignment">
34<link href="Type-Alignment.html" rel="prev" title="Type Alignment">
35<style type="text/css">
36<!--
37a.summary-letter {text-decoration: none}
38blockquote.indentedblock {margin-right: 0em}
39div.display {margin-left: 3.2em}
40div.example {margin-left: 3.2em}
41div.lisp {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}
47span.nolinebreak {white-space: nowrap}
48span.roman {font-family: initial; font-weight: normal}
49span.sansserif {font-family: sans-serif; font-weight: normal}
50ul.no-bullet {list-style: none}
51-->
52</style>
53
54
55</head>
56
57<body lang="en">
58<span id="Aliasing"></span><div class="header">
59<p>
60Next: <a href="Digraphs.html" accesskey="n" rel="next">Digraphs</a>, Previous: <a href="Type-Alignment.html" accesskey="p" rel="prev">Type Alignment</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Symbol-Index.html" title="Index" rel="index">Index</a>]</p>
61</div>
62<hr>
63<span id="Aliasing-1"></span><h2 class="appendix">Appendix B Aliasing</h2>
64<span id="index-aliasing-_0028of-storage_0029"></span>
65<span id="index-pointer-type-conversion"></span>
66<span id="index-type-conversion_002c-pointer"></span>
67
68<p>We have already presented examples of casting a <code>void *</code> pointer
69to another pointer type, and casting another pointer type to
70<code>void *</code>.
71</p>
72<p>One common kind of pointer cast is guaranteed safe: casting the value
73returned by <code>malloc</code> and related functions (see <a href="Dynamic-Memory-Allocation.html">Dynamic Memory Allocation</a>). It is safe because these functions do not save the
74pointer anywhere else; the only way the program will access the newly
75allocated memory is via the pointer just returned.
76</p>
77<p>In fact, C allows casting any pointer type to any other pointer type.
78Using this to access the same place in memory using two
79different data types is called <em>aliasing</em>.
80</p>
81<p>Aliasing is necessary in some programs that do sophisticated memory
82management, such as GNU Emacs, but most C programs don&rsquo;t need to do
83aliasing. When it isn&rsquo;t needed, <strong>stay away from it!</strong> To do
84aliasing correctly requires following the rules stated below.
85Otherwise, the aliasing may result in malfunctions when the program
86runs.
87</p>
88<p>The rest of this appendix explains the pitfalls and rules of aliasing.
89</p>
90<table class="menu" border="0" cellspacing="0">
91<tr><td align="left" valign="top">&bull; <a href="Aliasing-Alignment.html" accesskey="1">Aliasing Alignment</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Memory alignment considerations for
92 casting between pointer types.
93</td></tr>
94<tr><td align="left" valign="top">&bull; <a href="Aliasing-Length.html" accesskey="2">Aliasing Length</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Type size considerations for
95 casting between pointer types.
96</td></tr>
97<tr><td align="left" valign="top">&bull; <a href="Aliasing-Type-Rules.html" accesskey="3">Aliasing Type Rules</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Even when type alignment and size matches,
98 aliasing can still have surprising results.
99</td></tr>
100<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
101
102</pre></th></tr></table>
103
104
105
106
107</body>
108</html>
Note: See TracBrowser for help on using the repository browser.