Navigation:  thinBasic Modules > COMM >

COMM_Recv

Previous pageReturn to chapter overviewNext page

 

Description

 

Receive binary data from a serial port.

 

Syntax

 

COMM_Recv(hComm, NBytes, VariableBuffer)

 

Returns

 

None

 

Parameters

 

Name

Type

Optional

Meaning

hComm

Number

No

File number used by the COMM_OPEN statement to open the communications port.

NBytes

Number

No

The number of bytes to read from the open port.

VariableBuffer

Variable

No

A single string variable that will hold the received data from the serial port.

 

Remarks

 

Retrieve the NBytes number of bytes from hComm, placing the results in VariableBuffer.

Program execution will halt until NBytes bytes are available, so it is wise to check how many bytes are available before using this function.

You can do this by checking the %COMM_RXQUE value with the COMM_Get function like the following example:

 

NBytes = COMM_Get(hComm, %COMM_RXQUE).

 

Restrictions

 

See also

 

COMM_TRecv

 

Examples