Skip to main content


Reads a string of characters from the serial port




Name Type Description
numberOfChars Integer Optional number of characters to read (default = 80)


String — the characters read from the UART FIFO, or an empty string if the FIFO is empty


This method reads a specified numbers of bytes from the UART’s receive FIFO and returns them as a string. If you do not specify the number of characters you require — the numberOfChars parameter is optional — the method returns all of the available bytes as characters up to the size of the FIFO itself. By default, the receive FIFO is set at 80 characters is size. However, the size of the FIFO may be altered using uart.setrxfifosize().

If fewer characters than requested are available, the method will return a shorter string containing as many characters as there were bytes in the FIFO. If no data is available, it will return an empty string, "".

The method does not block.