Add contents for Structure/Pointer Access Operators

Author: rddcodes

Language/Structure/Pointer Access Operators/dereference.adoc

@@ -0,0 +1,55 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
+
+= * Dereference Operator
+
+
+// OVERVIEW SECTION STARTS
+[#overview]
+--
+
+[float]
+=== Description
+Dereferencing is one of the features specifically for use with pointers. The asterisk operator `*` is used for this purpose. If `p` is a pointer, then `*p` represents the value contained in the address pointed by `p`.
+[%hardbreaks]
+
+--
+// OVERVIEW SECTION ENDS
+
+
+
+// HOW TO USE SECTION STARTS
+[#howtouse]
+--
+
+[float]
+=== Example Code
+
+[source,arduino]
+----
+int *p;       // declare a pointer to an int data type
+int i = 5, result = 0;
+p = &i;       // now 'p' contains the address of 'i'
+result = *p;  // 'result' gets the value at the address pointed by 'p'
+              // i.e., it gets the value of 'i' which is 5
+----
+[%hardbreaks]
+
+[float]
+=== Notes and Warnings
+Pointers are one of the complicated subjects for beginners in learning C, and it is possible to write the vast majority of Arduino sketches without ever encountering pointers. However for manipulating certain data structures, the use of pointers can simplify the code, and and knowledge of manipulating pointers is handy to have in one's toolkit.
+[%hardbreaks]
+
+[float]
+=== See also
+
+[role="language"]
+* #LANGUAGE# link:reference{ext-relative}[& Reference Operator]
+
+[role="definition"]
+* #DEFINITION#  http://en.wikipedia.org/wiki/Pointer_%28computer_programming%29[Pointers^]
+
+--
+// HOW TO USE SECTION ENDS

Language/Structure/Pointer Access Operators/reference.adoc

@@ -0,0 +1,55 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
+
+= & Reference Operator
+
+
+// OVERVIEW SECTION STARTS
+[#overview]
+--
+
+[float]
+=== Description
+Referencing is one of the features specifically for use with pointers. The ampersand operator `&` is used for this purpose. If `x` is a variable, then `&x` represents the address of the variable `x`.
+[%hardbreaks]
+
+--
+// OVERVIEW SECTION ENDS
+
+
+
+// HOW TO USE SECTION STARTS
+[#howtouse]
+--
+
+[float]
+=== Example Code
+
+[source,arduino]
+----
+int *p;       // declare a pointer to an int data type
+int i = 5, result = 0;
+p = &i;       // now 'p' contains the address of 'i'
+result = *p;  // 'result' gets the value at the address pointed by 'p'
+              // i.e., it gets the value of 'i' which is 5
+----
+[%hardbreaks]
+
+[float]
+=== Notes and Warnings
+Pointers are one of the complicated subjects for beginners in learning C, and it is possible to write the vast majority of Arduino sketches without ever encountering pointers. However for manipulating certain data structures, the use of pointers can simplify the code, and and knowledge of manipulating pointers is handy to have in one's toolkit.
+[%hardbreaks]
+
+[float]
+=== See also
+
+[role="language"]
+* #LANGUAGE# link:dereference{ext-relative}[* Dereference Operator]
+
+[role="definition"]
+* #DEFINITION#  http://en.wikipedia.org/wiki/Pointer_%28computer_programming%29[Pointers^]
+
+--
+// HOW TO USE SECTION ENDS