StringToArray / StringToArrayU

PLCopen motion icon

Function A function calculates a result according to the current value of its inputs. A function has no internal data and is not linked to declared instances. - Copies the characters of a STRING to an array of SINT.

Inputs

Input	Data Type	Range	Unit	Default	Description
DST	SINT				Destination array of SINT small integers. USINT for StringToArrayU.
SRC	STRING				Source STRING.

Input

Data Type

Range

Unit

Default

Description

DST

SINT

Destination array of SINT small integers.

USINT for StringToArrayU.

SRC

STRING

Source STRING.

Outputs

Output	Data Type	Range	Unit	Description
Q	DINT			Number of characters copied.

Remarks

This function:

Copies the characters of the SRC string to the first characters of the DST array.
Checks the maximum size destination arrays and reduces the number of copied characters if necessary.

FBD Language Example

FFLD Language Example

In the FFLD "Free Form Ladder Diagram" Language, the operation is executed only if the input rung (EN) is TRUE.
- The output rung (ENO) keeps the same value as the input rung.

IL Language Example

In the IL "Instruction List" This is a low-level language and resembles assembly Language, the input must be loaded in the current result before calling the function.

Op1: LD "Ladder diagram"
Ladder logic is a method of drawing electrical logic schematics. It is now a very popular graphical language for programming Programmable Logic Controllers (PLCs). It was originally invented to describe logic made from relays. The name is based on the observation that programs in this language resemble ladders, with two vertical "rails" and a series of horizontal "rungs" between them           
SRC
StringToArray DST
ST "Structured text"
A high-level language that is block structured and syntactically resembles Pascal           Q

ST Language Example

Q := StringToArray (SRC, DST);