Cc_display_str – Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual

Page 148

Advertising
background image

API Library of Routines

Appendix B

CC_DISPLAY_STR

B-17

Copies four characters to the ASCII display.

C Syntax

#include <copro.h>

unsigned CC_DISPLAY_STR (str_ptr)

char *str_ptr;

Parameters

str_ptr

Specifies a pointer to the buffer that contains the characters to display.

Returns

Status

Symbolic Name

Meaning

0

CC_SUCCESS

Operation successful

159

CC_E_NOEXPANDER

Expander not present

Description

Use the CC_DISPLAY_STR function to display a 4 character string on the
optional ASCII display.

Important: ASCII display remains unchanged until another display
function call is performed successfully.

CC_DISPLAY_STR looks at the string as a four-character buffer.
Therefore, it is not necessary to include a null character as a terminator.
Likewise, any null character occurring within the four-character buffer
will be displayed.

CC_DISPLAY_STR

Advertising