print()

描述

透过序列埠印出具有阅读性的 ASCII 文字。这个函式有多种形式,你可以印出数字、符点数、字元或字串。请看以下范例:

  • Serial.print(78) 会是 78
  • Serial.print(1.23456) 会是 1.23
  • Serial.print('N') 会是 N
  • Serial.print("Hello world.") 会是 Hello world.

你可以使用第二个参数来指定格式 (此参数为非必需);可用的格式有:BIN (二进位格式)、OCT (八进位格式)、DEC (十进位格式)、HEX (十六进位格式)。对于符点数,这个参数可以指定小数点后的位数,请看以下范例:

  • Serial.print(78, BIN) 会是 1001110
  • Serial.print(78, OCT) 会是 116
  • Serial.print(78, DEC) 会是 78
  • Serial.print(78, HEX) 会是 4E
  • Serial.println(1.23456, 0) 会是 1
  • Serial.println(1.23456, 2) 会是 1.23
  • Serial.println(1.23456, 4) 会是 1.2346

若要送一个 byte,请使用 Serial.write()。

语法


Serial.print(val)
Serial.print(val, format)

参数

val: 要印的值 任意型别
format: 指定印出的格式 (对于整数的资料型别) 或小数点后的位数 (对于符点数资料型别)

回传

size_t (long):print() 的 byte 数

范例

/*
用 for 回圈印出指定格式的资料
*/
int x = 0;    // 宣告变数

void setup() {
  Serial.begin(9600);      // 设定 Serial 为 9600 鲍率
}

void loop() {  
  Serial.print("NO FORMAT");       // 印一个标签
  Serial.print("\t");              // 印一个 tab

  Serial.print("DEC");  
  Serial.print("\t");      

  Serial.print("HEX");
  Serial.print("\t");  

  Serial.print("OCT");
  Serial.print("\t");

  Serial.print("BIN");
  Serial.print("\t");

  for(x=0; x< 64; x++){    // 只印出 ASCII 表的一部分

    // 印出多种格式:
    Serial.print(x);       // 印出十进位的数字 - 等同于 "DEC"
    Serial.print("\t");    // 印一个 tab

    Serial.print(x, DEC);  // 印出十进位格式的数字
    Serial.print("\t");    // 印一个 tab

    Serial.print(x, HEX);  // 印出十六进位格式的数字
    Serial.print("\t");    // 印一个 tab

    Serial.print(x, OCT);  // 印出八进位格式的数字
    Serial.print("\t");    // 印一个 tab

    Serial.println(x, BIN);  // 印出二进位格式的数字
    //                             最后用 "println" 来换行
    delay(200);            // 延迟 200 毫秒
  }
  Serial.println("");      // 换行
}

提醒

序列埠传输属于非同步传输。当 Serial.print() 返回时,硬体可能还没送出任何字元。

See also

Serial
available()
begin()
end()
find()
findUntil()
flush()
parseFloat()
parseInt()
peek()
println()
read()
readBytes()
readBytesUntil()
setTimeout()
write()
serialEvent()


语法参考主页面

The text of the 86Duino reference is a modification of the Arduino reference, and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.