918af4f3ac
* change simulator svg * change radio image * Remove google fonts cdn * change color of 'advanced' button * font fix * font fix 2 * display fix * change fullsceen simulator bg * Continuous servo * handle continuous state * adding shims * update rendering for continuous servos * fixing sim * fix sig * typo * fix sim * bump pxt * bump pxt * rerun travis * Input blocks revision - add Button and Pin event types - merge onPinPressed & onPinReleased in new onPinEvent function - create new onButtonEvent function * update input blocks in docs and tests * remove device_pin_release block * Hide DAL.x behind Enum * bring back deprecated blocks, but hide them * shims and locales files * fix input.input. typing * remove buildpr * bump V3 * update simulator aspect ratio * add Loudness Block * revoke loudness block * Adds soundLevel To be replaced by pxt-common-packages when DAL is updated. * Remove P0 & P3 from AnalogPin Co-authored-by: Juri <gitkraken@juriwolf.de>
42 lines
938 B
Markdown
42 lines
938 B
Markdown
# Serial Read Line
|
|
|
|
Read a line of text from the serial port.
|
|
|
|
```sig
|
|
serial.readLine();
|
|
```
|
|
|
|
### ~hint
|
|
|
|
This function expects the line it reads to be terminated with the `\n`
|
|
character. If your terminal software does not terminate lines with
|
|
`\n`, this function will probably never return a value.
|
|
|
|
|
|
You can override the ``serial.NEW_LINE_DELIMITER`` field to change the newline delimiter.
|
|
|
|
### ~
|
|
|
|
## Returns
|
|
|
|
* a [string](/types/string) containing input from the serial port, such as a response typed by a user
|
|
|
|
## Example
|
|
|
|
The following example requests the user's name, then repeats it to greet the user.
|
|
|
|
```blocks
|
|
basic.forever(() => {
|
|
serial.writeLine("What is your name?");
|
|
let answer = serial.readLine();
|
|
serial.writeString("Hello,");
|
|
serial.writeLine(answer);
|
|
});
|
|
```
|
|
|
|
## See also
|
|
|
|
[serial](/device/serial),
|
|
[serial write line](/reference/serial/write-line),
|
|
[serial write value](/reference/serial/write-value)
|