source: public/doc/gnu-c/Referencing-Fields.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: 4.8 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>Referencing Fields (GNU C Language Manual)</title>
23
24<meta name="description" content="Referencing Fields (GNU C Language Manual)">
25<meta name="keywords" content="Referencing Fields (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="Structures.html" rel="up" title="Structures">
33<link href="Dynamic-Memory-Allocation.html" rel="next" title="Dynamic Memory Allocation">
34<link href="Structures.html" rel="prev" title="Structures">
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="Referencing-Fields"></span><div class="header">
59<p>
60Next: <a href="Dynamic-Memory-Allocation.html" accesskey="n" rel="next">Dynamic Memory Allocation</a>, Up: <a href="Structures.html" accesskey="u" rel="up">Structures</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="Referencing-Structure-Fields"></span><h3 class="section">15.1 Referencing Structure Fields</h3>
64<span id="index-referencing-structure-fields"></span>
65<span id="index-structure-fields_002c-referencing"></span>
66
67<p>To make a structure useful, there has to be a way to examine and store
68its fields. The &lsquo;<samp>.</samp>&rsquo; (period) operator does that; its use looks
69like <code><var>object</var>.<var>field</var></code>.
70</p>
71<p>Given this structure and variable,
72</p>
73<div class="example">
74<pre class="example">struct intlistlink
75 {
76 int datum;
77 struct intlistlink *next;
78 };
79
80struct intlistlink foo;
81</pre></div>
82
83<p>you can write <code>foo.datum</code> and <code>foo.next</code> to refer to the two
84fields in the value of <code>foo</code>. These fields are lvalues, so you
85can store values into them, and read the values out again.
86</p>
87<p>Most often, structures are dynamically allocated (see the next
88section), and we refer to the objects via pointers.
89<code>(*p).<var>field</var></code> is somewhat cumbersome, so there is an
90abbreviation: <code>p-&gt;<var>field</var></code>. For instance, assume the program
91contains this declaration:
92</p>
93<div class="example">
94<pre class="example">struct intlistlink *ptr;
95</pre></div>
96
97<p>You can write <code>ptr-&gt;datum</code> and <code>ptr-&gt;next</code> to refer
98to the two fields in the object that <code>ptr</code> points to.
99</p>
100<p>If a unary operator precedes an expression using &lsquo;<samp>-&gt;</samp>&rsquo;,
101the &lsquo;<samp>-&gt;</samp>&rsquo; nests inside:
102</p>
103<div class="example">
104<pre class="example"> -ptr-&gt;datum <span class="roman">is equivalent to</span> -(ptr-&gt;datum)
105</pre></div>
106
107<p>You can intermix &lsquo;<samp>-&gt;</samp>&rsquo; and &lsquo;<samp>.</samp>&rsquo; without parentheses,
108as shown here:
109</p>
110<div class="example">
111<pre class="example">struct { double d; struct intlistlink l; } foo;
112
113<span class="roman">&hellip;</span>foo.l.next-&gt;next-&gt;datum<span class="roman">&hellip;</span>
114</pre></div>
115
116
117
118
119</body>
120</html>
Note: See TracBrowser for help on using the repository browser.