This page is also available in 3 other languages

Keyboard.print()

Description

Sends a keystroke to a connected computer.

Keyboard.print() must be called after initiating Keyboard.begin().

Syntax

Keyboard.print(character)
Keyboard.print(characters)

Parameters

character: a char or int to be sent to the computer as a keystroke.
characters: a string to be sent to the computer as a keystroke.

Returns

Number of bytes sent. Data type: size_t.

Example Code

#include <Keyboard.h>

void setup() {
  // make pin 2 an input and turn on the
  // pullup resistor so it goes high unless
  // connected to ground:
  pinMode(2, INPUT_PULLUP);
  Keyboard.begin();
}

void loop() {
  //if the button is pressed
  if (digitalRead(2) == LOW) {
    //Send the message
    Keyboard.print("Hello!");
  }
}

Notes and Warnings

When you use the Keyboard.print() command, the Arduino takes over your keyboard! Make sure you have control before you use the command. A pushbutton to toggle the keyboard control state is effective.