INSCHRS

  .  Summary

  inschrs(str <source>, str <target>, int <pos>, int <num>);

  .  Description

  The inschrs function is used to insert characters from one string
  into another at a specific position, shifting existing characters to
  the right. Characters are taken from <source> and placed in
  <target>, at an offset indicated by <pos>. Note that string offsets
  are numbered starting at 0, so the first character would have an
  offset of 0, the second 1, etc. Only <num> characters are inserted,
  and existing characters are shifted to the right (and are lost if
  they shift past the space allocated for the string).

  .  Return Value

  None.

  .  Example

  str test[24] = "Good-bye";
  // add "Hello" to the front of the existing string
  inschrs("Hello ", test, 0, 6);