h6. [[OS SWI Calls]] h6(. » OS_GSInit h2. OS_GSInit h5. (SWI &25) |_<^{width:4em}. Entry | | |<^. R0 |<^. String to translate | |<^. R2 |<^. [[GS Flags|Flags]] | |_<^{width:4em}. Exit | | |<^. R0 |<^. Value for [[OS_GSRead]] | |<^. R1 |<^. 1[^st^] non-blank character | |<^. R2 |<^. Value for [[OS_GSRead]] | h4. Use The purpose of this call is to initialise registers for use by [[OS_GSRead]]. h4. Notes OS_GSInit is one of the string routines which are used by the operating system CLI to process text strings. This SWI is followed by repeated calls to OS_Read. One of the advantages of these routines is that they enable the use the character ‘|’ to introduce control characters which would otherwise be difficult to enter directly from the keyboard. OS_GSInit also returns the first non-blank character in the string. However, this is not necessarily the same as the output from the first OS_GSRead, since OS_GSInit doesn’t perform any expansion. h4. See also * [[GS Flags]] * [[GS Translations]] * [[OS_GSRead]] * [[OS_GSTrans]]