#include
Description
#include
is used to include outside libraries in your sketch. This gives the programmer access to a large group of standard C libraries (groups of pre-made functions), and also libraries written especially for Arduino.The main reference page for AVR C libraries (AVR is a reference to the Atmel chips on which the Arduino is based) is here.
Note that
#include
, similar to #define
, has no semicolon terminator, and the compiler will yield cryptic error messages if you add one.Syntax
#include <LibraryFile.h>
#include "LocalFile.h"
Parameters
: when the angle brackets syntax is used, the libraries paths will be searched for the file.LibraryFile.h
: When the double quotes syntax is used, the folder of the file using theLocalFile.h
directive will be searched for the specified file, then the libraries paths if it was not found in the local path. Use this syntax for header files in the sketch’s folder.#include
Example Code
This example includes the Servo library so that its functions may be used to control a Servo motor.
1#include <Servo.h>2
3 Servo myservo; // create servo object to control a servo4
5 void setup() {6 myservo.attach(9); // attaches the servo on pin 9 to the servo object7 }8
9 void loop() {10 for (int pos = 0; pos <= 180; pos += 1) { // goes from 0 degrees to 180 degrees11 // in steps of 1 degree12 myservo.write(pos); // tell servo to go to position in variable 'pos'13 delay(15); // waits 15ms for the servo to reach the position14 }15 for (int pos = 180; pos >= 0; pos -= 1) { // goes from 180 degrees to 0 degrees16 myservo.write(pos); // tell servo to go to position in variable 'pos'17 delay(15); // waits 15ms for the servo to reach the position18 }19 }
See also
Suggest changes
The content on docs.arduino.cc is facilitated through a public GitHub repository. If you see anything wrong, you can edit this page here.
License
The Arduino documentation is licensed under the Creative Commons Attribution-Share Alike 4.0 license.