Do-more Technical Training Instruction Set (String)

Instruction Set THE BASICS ▫1▫181 instructions CContact (14) CCoil/Bit Output (11) AAnalog/Process (13) DDate/Time/Calendar (7) EEthernet (5) HHardware/Device (9) HHigh Speed/CTRIO (19) MMath (5) MMisc/Data Manipulation (23) PProgram Control (20) PProgram-Looping (8) PProtocol-Custom/ASCII (7) PProtocol-Standard (10) SString (14) TTimer/Counter/Drum (16)

String ▫STR2INT ▫STR2REAL ▫STRCASE ▫STRCLEAR ▫STRCMP ▫STRDELETE ▫STRFIND ▫STRGETB ▫STRINSERT ▫STRPRINT ▫STRPUTB ▫STRSUB ▫STRTRIM ▫STRTRUNC Instruction Set (String)

STR2INT “Convert String to Integer” ▫C▫Converts ASCII digits to integer value ▫P▫Parameters: IInput String – string to be converted IInput Radix – determines valid characters DDecimal (base 10): characters “0-9” HHexadecimal (base 16): characters “0-F” OOctal (base 8): characters “0-7” IImplied Base: characters “0x” (hex), “0” (octal), “1-9”(decimal) OOther (2-36): e.g. 36 would validate characters “0-Z” NNumeric Output – location of converted value IIndex Where Stopped – character location in string ▫N▫NOTES: IIf Input String is empty then Index Where Stopped = -1; ERR = “STR2INT input string is empty” IIf Input String contains invalid characters then Index Where Stopped = -1; ERR = “STR2INT input string couldn’t be converted to an integer value”

STR2REAL “Convert String to Real” ▫C▫Converts ASCII digits to real value ▫P▫Parameters: IInput String – string to be converted NNumeric Output – location of converted value IIndex Where Stopped – character location in string ▫N▫NOTES: VValid characters are: “ E+-” IIf Input String is empty then Index Where Stopped = -1; ERR = “STR2REAL input string is empty” IIf Input String contains invalid characters then Index Where Stopped = -1; ERR = “STR2REAL input string couldn’t be converted to an integer value”

STRCASE “Convert String to UPPER/lower Case” ▫C▫Converts all characters in a string to either upper case or lower case letters ▫P▫Parameters: IInput/Output String – string to be converted CConvert to: aall lower case AALL UPPER CASE ▫N▫NOTES: VValid characters are only alphabetic letters IIf character is not alphabetic, no change occurs to that character SS0abcd!EFgH abcd!efgh LowLow ABCD!EFGH UpUp

Instruction Set (String) STRCLEAR “Clear Strings” ▫D▫Deletes all characters from a single string or a range of strings ▫P▫Parameters: SStart String – 1 st (or only) string to be cleared NNumber of Strings to Clear – 1 to (or variable) ▫N▫NOTES: TThe Status display will only show as many characters that fit in its borders (about 50 characters)

STRCMP “String Compare” ▫C▫Compares two strings to determine if they are equal, less than or greater than ▫L▫Less than & greater than values are determined by the ASCII byte values ▫E▫Each byte position is compared until: BByte values don’t match with one value > or < EEnd of one string reached 1 st meaning it is < EEnd of both strings reached simultaneously meaning equality ▫P▫Parameters: FFirst String CCase Sensitive: YYes, upper/lower case are different NNo, upper/lower case are equal SSet If Equal (optional) SSet If Less Than (optional) SSet If Greater Than (optional) SSecond String or Text – the 2 nd string can be a literal text in quotes IInput Leg: EEdge triggered PPower flow enabled SS0abcd!EFgH SS1abcd!EFgH Yes, upper/lower case are different SS0 = SS1SS0 < SS1SS0 > SS1 YES No, upper/lower case are equal YES SS0abcd!EFgH SS1abcd!E Yes, upper/lower case are different SS0 = SS1SS0 < SS1SS0 > SS1 YES No, upper/lower case are equal YES SS0abcd!EFgH SS1abcd!eF Yes, upper/lower case are different SS0 = SS1SS0 < SS1SS0 > SS1 YES No, upper/lower case are equal YES E = 45 hex e = 65 hex SS0’s E is < SS1’s e SS0’s E & SS1’s e are equal in value & SS0 is longer

Instruction Set (String) STRDELETE “Delete Substring” ▫D▫Deletes characters from a string ▫T▫Trailing characters are shifted to take the place of deleted ones ▫P▫Parameters: IInput / Output String SStarting at Offset: 0 – 1023 (or variable) TThe 1 st character is 0 (zero) NNumber of Characters to Delete SS0abcd!EFgH To delete the ! character: Starting at Offset = 4 Number of Characters to Delete = SS0abcdEFgH

Instruction Set (String) STRFIND “Find within String” ▫S▫Search a target string for a particular string ▫I▫If successful the where-found offset could be used in STRSUB, STRDELETE or STRINSERT instructions ▫P▫Parameters: FFind within – string in which to search SSearch from: BBeginning to end EEnd to beginning CCase Sensitive: YYes, upper/lower case are different NNo, upper/lower case are equal IIn Offset: Start / Out Offset: Where Found – will contain -1 if nothing is found SSet if found (optional) SSet if NOT found (optional) FFind Text/String: EExact sequence AAny one of these characters – text box IInput Leg: EEdge triggered / Power flow enabled SS0abceEEFgH To find the E character: Search from: Beginning to end Case Sensitive: Yes Find Text/String: Any one of these characters: “E”

Instruction Set (String) STRPUTB “Put Bytes Into a String” ▫P▫Puts bytes of data from a specified location range into a string ▫P▫Parameters: PPut Into String – string that will contain data bytes SStart at Index – 1 st location in the string for the bytes LLength in Bytes – number of bytes to write into string FFrom Starting Element – 1 st location to read bytes <<Create Byte Buffer> button – convenient way to create a Memory Block of bytes (shows up in Memory Configuration) ▫N▫NOTES: NNot intended to operate on strings with ASCII text

STRGETB “Get Bytes Out of a String” ▫E▫Extracts bytes of data out of a string & stores them in specified location ▫P▫Parameters: GGet out of String – string with data bytes SStart at Index – 1 st location in the string for the bytes LLength in Bytes – number of bytes to copy IInto Starting Element – 1 st location to put extracted bytes <<Create Byte Buffer> button – convenient way to create a Memory Block of bytes (shows up in Memory Configuration) ▫N▫NOTES: NNot intended to operate on strings with ASCII text Values are manually written to a custom byte memory MyBuffer The STRPUTB writes the range MyBuffer10-13 into SS0 The STRGETB writes the bytes in SS0 to the range MyBuffer0-3 ASCII values of 10, 20, 30 are not displayable characters. 40 decimal ASCII is (.

Instruction Set (String) STRINSERT “Insert Substring” ▫I▫Inserts characters into a string ▫P▫Parameters: IInsert String or Text IInto String SStarting at Offset IIf > length of string, it is appended to string IIf > allowable size of the Into String, then: ▫T▫Text is appended to string ▫$▫$OutOfRange (ST132) = ON ▫E▫ERR = “Argument out of range in STRINSERT…” The text “not ” is to be inserted into SS0 starting at offset 12.

Instruction Set (String) STRPRINT “Print to String” ▫W▫Writes text & formatted data into a string ▫P▫Parameters: PPrint to AAppend to String (optional) AAutomatically insert space after each term (optional) PPrint Script – text with optional embedded fields (text, control characters, strings, elements, formatting & string selection functions, raw data) – See next slide  IInput Leg – Edge triggered / Power flow enabled

Instruction Set (Ethernet) STRPRINT “Print to String” ▫P▫Parameters: PPrint Script SString Literals – ASCII text in double quotes (e.g. “Hi!”) DData Elements – (e.g. “The current count is” CT0.Acc) CControl Characters ▫$▫$$  $ ▫$▫$”  “ ▫$▫$L  <LF> (line feed) ▫$▫$N  <CR><LF> (carriage return, line feed) ▫$▫$P  <FF> (form feed) ▫$▫$R  <CR> (carriage return) ▫$▫$T  <TAB> (tab) ▫$▫$hh  hh (any one-byte hex value) FFormatting Functions [see Do-more Designer Help Topic DMD0168] ▫F▫FmtString – Sets length and/or justifies text within a string ▫F▫FmtBit – Formats bits’ values as a text instead of just 0 or 1 ▫F▫FmtInt – Formats how an integer is represented in a string ▫F▫FmtReal – Formats how real numbers are represented in a string ▫F▫FmtTMR – Formats how Timer Accumulator values are represented in a string ▫F▫FmtDate – Formats how a Date stamp is represented in a string ▫F▫FmtTime – Formats how a Time stamp is represented in a string ▫L▫Lookup – Selects a string in a list to represent a value ▫R▫Raw – Places bytes of data from a data block into a string

Instruction Set (String) STRSUB “Get Sub-String” ▫C▫Copies characters from one string to another ▫P▫Parameters: IInput String SStarting Offset OOffset From – Beginning / End LLength – variable or Remainder of input string OOutput String IInput Leg – Edge triggered / Power flow enabled

STRTRIM “Trim Whitespace” ▫R▫Removes all whitespace characters from the beginning and/or end of a string WWhat is “Whitespace”?  SSpace (ASCII 20 hex) HHorizontal tab <TAB> (ASCII 09 hex) CCarriage return <CR> (ASCII 0D hex) LLine feed <LF> (ASCII 0A hex) FForm feed <FF> (ASCII 0C hex) VVertical tab <VT> (ASCII 0B hex) ▫P▫Parameters: SString TTrim LLeading (optional) TTrailing (optional)

STRTRUNC “Set String Length” ▫S▫Sets the length of a string ▫P▫Parameters: SString LLength IIf 0 (zero) or negative (-) clears string <empty string> IIf > string’s length then string is padded with nulls (0; not spaces) to reach the specified length IIf > string’s allowed length (e.g. >64 for SS, >256 for SL) then entire string is padded with nulls (0; not spaces) and… ▫$▫$BufferOverflow (ST140) = ON ▫E▫ERR: “Length was greater than max string length in STRTRUNC…”