33 buffer. The back pointer simply points to the first byte of the single region |
33 buffer. The back pointer simply points to the first byte of the single region |
34 of memory (as illustrated below); <codeph>End()</codeph> always returns a |
34 of memory (as illustrated below); <codeph>End()</codeph> always returns a |
35 pointer to the first byte following the end of the buffer, while <codeph>Back()</codeph> always |
35 pointer to the first byte following the end of the buffer, while <codeph>Back()</codeph> always |
36 returns a pointer to the beginning of the buffer.</p> <fig id="GUID-D4084F4C-B928-5779-A58F-CB495A74EE68"> |
36 returns a pointer to the beginning of the buffer.</p> <fig id="GUID-D4084F4C-B928-5779-A58F-CB495A74EE68"> |
37 <title>End() and Back() in fixed flat arrays</title> |
37 <title>End() and Back() in fixed flat arrays</title> |
38 <image href="GUID-81A5784D-A0C6-5108-9E7B-5D39C6743B1A_d0e220584_href.png" placement="inline"/> |
38 <image href="GUID-81A5784D-A0C6-5108-9E7B-5D39C6743B1A_d0e216847_href.png" placement="inline"/> |
39 </fig> </section> |
39 </fig> </section> |
40 <section id="GUID-27F85346-3B08-4E06-A80D-A5B708105659"><title>Segmented array</title> <p>For a segmented array, the situation |
40 <section id="GUID-27F85346-3B08-4E06-A80D-A5B708105659"><title>Segmented array</title> <p>For a segmented array, the situation |
41 is different (as illustrated below). Looking at the segment containing elements <codeph>n</codeph> and <codeph>n+1</codeph>, <codeph>End()</codeph> returns a pointer to the first byte following the end of that segment. In |
41 is different (as illustrated below). Looking at the segment containing elements <codeph>n</codeph> and <codeph>n+1</codeph>, <codeph>End()</codeph> returns a pointer to the first byte following the end of that segment. In |
42 fact, <codeph>End()</codeph> returns the same pointer value for all elements |
42 fact, <codeph>End()</codeph> returns the same pointer value for all elements |
43 in that segment. <codeph>Back()</codeph> returns a pointer to the beginning |
43 in that segment. <codeph>Back()</codeph> returns a pointer to the beginning |
45 in that segment. However, for the <i>first</i> element in that segment, <codeph>Back()</codeph> returns |
45 in that segment. However, for the <i>first</i> element in that segment, <codeph>Back()</codeph> returns |
46 a pointer to the beginning of the <i>previous</i> segment. For the very first |
46 a pointer to the beginning of the <i>previous</i> segment. For the very first |
47 element in the array, <codeph>Back()</codeph> returns a pointer with a NULL |
47 element in the array, <codeph>Back()</codeph> returns a pointer with a NULL |
48 value.</p> <fig id="GUID-90C05AF9-9048-557E-95DD-49A19F856EF0"> |
48 value.</p> <fig id="GUID-90C05AF9-9048-557E-95DD-49A19F856EF0"> |
49 <title>End() and Back() in fixed segmented arrays</title> |
49 <title>End() and Back() in fixed segmented arrays</title> |
50 <image href="GUID-C0CFFE13-579C-5A93-9B63-DC2DCF98EC61_d0e220633_href.png" placement="inline"/> |
50 <image href="GUID-C0CFFE13-579C-5A93-9B63-DC2DCF98EC61_d0e216896_href.png" placement="inline"/> |
51 </fig> </section> |
51 </fig> </section> |
52 <section id="GUID-165D9F3E-3948-4DC0-9632-FF70480C495C"><title>See also</title> <p><xref href="GUID-112AAFA5-B4C9-5B62-A106-FB5097C13A0E.dita">Dynamic |
52 <section id="GUID-165D9F3E-3948-4DC0-9632-FF70480C495C"><title>See also</title> <p><xref href="GUID-112AAFA5-B4C9-5B62-A106-FB5097C13A0E.dita">Dynamic |
53 Buffers Guide</xref>.</p> </section> |
53 Buffers Guide</xref>.</p> </section> |
54 </conbody></concept> |
54 </conbody></concept> |