source: public/doc/gnu-c/Pointer-Arithmetic-Low-Level.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.6 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>Pointer Arithmetic Low Level (GNU C Language Manual)</title>
23
24<meta name="description" content="Pointer Arithmetic Low Level (GNU C Language Manual)">
25<meta name="keywords" content="Pointer Arithmetic Low Level (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="Pointers.html" rel="up" title="Pointers">
33<link href="Pointer-Increment_002fDecrement.html" rel="next" title="Pointer Increment/Decrement">
34<link href="Pointers-and-Arrays.html" rel="prev" title="Pointers and Arrays">
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="Pointer-Arithmetic-Low-Level"></span><div class="header">
59<p>
60Next: <a href="Pointer-Increment_002fDecrement.html" accesskey="n" rel="next">Pointer Increment/Decrement</a>, Previous: <a href="Pointers-and-Arrays.html" accesskey="p" rel="prev">Pointers and Arrays</a>, Up: <a href="Pointers.html" accesskey="u" rel="up">Pointers</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="Pointer-Arithmetic-at-Low-Level"></span><h3 class="section">14.12 Pointer Arithmetic at Low Level</h3>
64<span id="index-pointer-arithmetic_002c-low-level"></span>
65<span id="index-low-level-pointer-arithmetic"></span>
66
67<p>The behavior of pointer arithmetic is theoretically defined only when
68the pointer values all point within one object allocated in memory.
69But the addition and subtraction operators can&rsquo;t tell whether the
70pointer values are all within one object. They don&rsquo;t know where
71objects start and end. So what do they really do?
72</p>
73<p>Adding pointer <var>p</var> to integer <var>i</var> treats <var>p</var> as a memory
74address, which is in fact an integer&mdash;call it <var>pint</var>. It treats
75<var>i</var> as a number of elements of the type that <var>p</var> points to.
76These elements&rsquo; sizes add up to <code><var>i</var> * sizeof (*<var>p</var>)</code>.
77So the sum, as an integer, is <code><var>pint</var> + <var>i</var> * sizeof
78(*<var>p</var>)</code>. This value is reinterpreted as a pointer like <var>p</var>.
79</p>
80<p>If the starting pointer value <var>p</var> and the result do not point at
81parts of the same object, the operation is not officially legitimate,
82and C code is not &ldquo;supposed&rdquo; to do it. But you can do it anyway,
83and it gives precisely the results described by the procedure above.
84In some special situations it can do something useful, but non-wizards
85should avoid it.
86</p>
87<p>Here&rsquo;s a function to offset a pointer value <em>as if</em> it pointed to
88an object of any given size, by explicitly performing that calculation:
89</p>
90<div class="example">
91<pre class="example">#include &lt;stdint.h&gt;
92
93void *
94ptr_add (void *p, int i, int objsize)
95{
96 intptr_t p_address = (long) p;
97 intptr_t totalsize = i * objsize;
98 intptr_t new_address = p_address + totalsize;
99 return (void *) new_address;
100}
101</pre></div>
102
103<p><span id="index-intptr_005ft"></span>
104This does the same job as <code><var>p</var> + <var>i</var></code> with the proper
105pointer type for <var>p</var>. It uses the type <code>intptr_t</code>, which is
106defined in the header file <samp>stdint.h</samp>. (In practice, <code>long
107long</code> would always work, but it is cleaner to use <code>intptr_t</code>.)
108</p>
109<hr>
110<div class="header">
111<p>
112Next: <a href="Pointer-Increment_002fDecrement.html" accesskey="n" rel="next">Pointer Increment/Decrement</a>, Previous: <a href="Pointers-and-Arrays.html" accesskey="p" rel="prev">Pointers and Arrays</a>, Up: <a href="Pointers.html" accesskey="u" rel="up">Pointers</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>
113</div>
114
115
116
117</body>
118</html>
Note: See TracBrowser for help on using the repository browser.