Serial.println()

Last revision:2025/06/13

名称

Serial.println()

説明

シリアルポートにASCIIテキストとして可読文字を表示する。指定した文字を表示した後、復帰(CR、ASCIIコード13, ‘\r’)と改行(LF、ASCIIコード10,’\n’)とを送信する。このコマンドは、指定した引数の最後にCR/LFを送信する以外は、Serial.print()と同様である。

書式

シリアル通信でデータを表示するには、以下の関数を使う。

  • Serial.println(val)
  • Serial.println(val, format)

C言語シグネチャ(avr)

size_t Print::println(const String &s);

size_t Print::println(const char c[]);

size_t Print::println(char c);

size_t Print::println(unsigned char b, int base);

size_t Print::println(int num, int base);

size_t Print::println(unsigned int num, int base);

size_t Print::println(long num, int base);

size_t Print::println(unsigned long num, int base);

size_t Print::println(double num, int digits);

size_t Print::printlnln(const __FlashStringHelper *ifsh);

size_t Print::println(const Printable& x);

size_t Print::println(void);

引数

この関数は以下のオブジェクトと引数を受け付ける。

Serialシリアルポートオブジェクト。各ボードで利用可能なシリアルポートオブジェクトは、Serialを参照。
val, s, str, c, b, n, ifsh, x表示する値。データ型: 任意の型。
format, base表示する値が整数型の場合は底、浮動小数型の場合は小数点以下の表示桁数。
digits小数点以下の表示桁数(省略時は2)

戻り値

書き込んだバイト数。戻り値の利用はオプション。データ型: size_t

コード例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
/*
 Analog input reads an analog input on analog in 0, prints the value out.
 created 24 March 2006
 by Tom Igoe
 */

int analogValue = 0;    // variable to hold the analog value

void setup() {
  // open the serial port at 9600 bps:
  Serial.begin(9600);
}

void loop() {
  // read the analog input on pin 0:
  analogValue = analogRead(0);

  // print it out in many formats:
  Serial.println(analogValue);       // print as an ASCII-encoded decimal
  Serial.println(analogValue, DEC);  // print as an ASCII-encoded decimal
  Serial.println(analogValue, HEX);  // print as an ASCII-encoded hexadecimal
  Serial.println(analogValue, OCT);  // print as an ASCII-encoded octal
  Serial.println(analogValue, BIN);  // print as an ASCII-encoded binary

  // delay 10 milliseconds before the next reading:
  delay(10);
}

注意

Serial.println()の非同期性に関する情報は、Serial.write()の注意を参照。

オリジナルのページ

https://docs.arduino.cc/language-reference/en/functions/communication/serial/println/

実装の解析

まだ解析していません。

最終更新日

August 16, 2026

inserted by FC2 system