ROM BYTE* TCPPutROMString( TCP_SOCKET hTCP, ROM BYTE* Data );
Writes a null-terminated string from ROM to a TCP socket. The null-terminator is not copied to the socket.
TCP is initialized.
Parameters |
Description |
hTCP |
The socket to which data is to be written. |
data |
Pointer to the string to be written. |
Pointer to the byte following the last byte written to the socket. If this pointer does not dereference to a NUL byte, the buffer became full or the socket is not connected.
The return value of this function differs from that of TCPPutArray. To write long strings in a single state, initialize the *data pointer to the first byte, then call this function repeatedly (breaking to the main stack loop after each call) until the return value dereferences to a NUL byte. Save the return value as the new starting *data pointer otherwise.
This function is aliased to TCPPutString on non-PIC18 platforms.