名称
Serial.print()
説明
シリアルポートにASCIIテキストとして可読文字を表示する。この関数には多くの呼び出し形式がある。数値はそれぞれの数字をASCII文字を使って表示される。浮動小数点は同様に数字をASCII文字を使って、デフォルトでは小数点以下第2位まで表示する。バイトは数値をASCII文字に変換して送信される。文字や文字列はそのまま送信される。
Serial.print(78)は “78”Serial.print(1.23456)は “1.23”Serial.print('N')は “N”Serial.print("Hello world.")は “Hello world.”
オプションの第2引数は、底や形式を指定する。BIN(2進表記)、OCT(8進表記)、DEC(10進表記)、HEX(16進表記)が指定可能である。浮動小数点に対しては、この引数は、小数点以下第何位までを表示するかを指定する。
Serial.print(78, BIN)は “1001110”Serial.print(78, OCT)は “116”Serial.print(78, DEC)は “78”Serial.print(78, HEX)は “4E”Serial.print(1.23456, 0)は “1”Serial.print(1.23456, 2)は “1.23”Serial.print(1.23456, 4)は “1.2346”
F()を使って、フラッシュメモリ上の文字列をSerial.print()に送ることもできる。例えば、以下のように使う。
Serial.print(F(“Hello World”));
文字の表現を変えずに送信する場合は、Serial.write()を使うこと。
書式
シリアル通信でデータを表示するには、以下の関数を使う。
Serial.print(val)Serial.print(val, format)
C言語シグネチャ(avr)
size_t Print::print(const String &s);
size_t Print::print(const char str[]);
size_t Print::print(char c);
size_t Print::print(unsigned char b, int base);
size_t Print::print(int n, int base);
size_t Print::print(unsigned int n, int base);
size_t Print::print(long n, int base);
size_t Print::print(unsigned long n, int base);
size_t Print::print(double n, int digits);
size_t Print::println(const __FlashStringHelper *ifsh);
size_t Print::print(const Printable& x);
引数
この関数は以下のオブジェクトと引数を受け付ける。
| Serial | シリアルポートオブジェクト。各ボードで利用可能なシリアルポートオブジェクトは、Serialを参照。 |
| val, s, str, c, b, n, ifsh, x | 表示する値。データ型: 任意の型。 |
| format, base | 表示する値が整数型の場合は底、浮動小数型の場合は小数点以下の表示桁数。 |
| digits | 小数点以下の表示桁数(省略時は2) |
戻り値
書き込んだバイト数。戻り値の利用はオプション。データ型: size_t。
コード例
|
|
注意
Serial.print()の非同期性に関する情報は、Serial.write()の注意を参照。
参照
オリジナルのページ
https://docs.arduino.cc/language-reference/en/functions/communication/serial/print/
実装の解析
まだ解析していません。
最終更新日
July 18, 2026