HPlogo System Debug Reference Manual > Chapter 10 System Debug Standard Functions

func strins

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

String insert. Returns a string after inserting another string into the source string.

Syntax



   strins (insert source position)

Formal Declaration



   strins:str (insert:str source:str position:u16)

Parameters


insert

The string to be inserted into source.

source

The source string into which insert is to be inserted.

position

The position where insert is to be inserted in source. String indices are 1-based. (That is, indices are 1, 2, 3, ... rather than 0, 1, 2, ...) If position is greater than the string length of source, insert is appended to source.

Examples



   $nmdebug > var name "Smith, "
   $nmdebug > wl strins(name, "Dear Ms. How are You?", 10)
   Dear Ms. Smith, How are You?

Insert the string variable NAME into a literal string at position 10.

   $nmdebug > wl strins(" NOW!", "Go Home", 100):"qo"
   "Go Home NOW!"

Insert "NOW!" into the source at position 100. Since the source is only seven characters long, "NOW!" is appended at the end of the source string.

Limitations, Restrictions


If the resultant string is larger than the maximum supported string length (see the STRMAX function), it is truncated.




func strinput


func strlen