Serial.println()

Leírás

Az adatokat ember által olvasható ASCII-szövegként nyomtatja ki a soros portra, amelyet egy kocsivissza karakter (ASCII 13 vagy '\r') és egy újsor karakter (ASCII 10 vagy '\n') követ. Ez a parancs ugyanazokat a formákat alkalmazza, mint a Serial.print().

Szintaxis

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

Paraméterek

Serial: soros port objektum. Tekintse meg az egyes kártyákhoz elérhető soros portok listáját a Serial főoldalon.
val: a nyomtatandó érték. Engedélyezett adattípusok: bármilyen adattípus.
format: megadja a számok alapját (egész adattípusoknál) vagy a tizedesjegyek számát (lebegőpontos típusoknál).

Visszatérési érték

A println() a megírt bájtok számát adja vissza, bár ennek a számnak a beolvasása nem kötelező. Adattípus: size_t.

Példa

/*
 Beolvassa a 0 analóg bemenetet, és kiírja az értéket.
 létrehozva 24 Márc 2006
 by Tom Igoe
 */

int analogValue = 0;    // változó az analóg érték tárolásához

void setup() {
  // a serial port megnyitása 9600 bps-sel:
  Serial.begin(9600);
}

void loop() {
  // analóg input a 0 pinről:
  analogValue = analogRead(0);

  // nyomtatás több formában:
  Serial.println(analogValue);       // ASCII-kódolású decimálisként nyomtat
  Serial.println(analogValue, DEC);  // ASCII-kódolású decimálisként nyomtat
  Serial.println(analogValue, HEX);  // ASCII-kódolású hexadecimálisként nyomtat
  Serial.println(analogValue, OCT);  // ASCII-kódolású oktálisként nyomtat
  Serial.println(analogValue, BIN);  // ASCII-kódolású binárisként nyomtat

  // 10 milisecundum várakozás a következő olvasásig:
  delay(10);
}

Megjegyzések és figyelmeztetések

A Serial.print() aszinkronitásáról a Serial.write() hivatkozási oldal Megjegyzések és figyelmeztetések szakaszában olvashat.