XLISP nstring-upcase

Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference

# nstring-upcase

Type: | - | function (subr)
Source: | - | xlstr.c

## Syntax

(nstring-upcase string [{:start | :end} offset] ... )
  string - a string expression
  offset - an optional integer expression for a keyword
  returns - the converted string, not a copy

## Description

The 'nstring-upcase' function takes a string argument and makes it upper case. This function modifies the string or string variable itself, it does not just make a copy. The upper case string is returned.

The keyword arguments allow for accessing substrings within 'string'. The keyword arguments require a keyword (':start' or ':end') first and a single integer expression second. The ':start' keyword specifies the starting offset for the 'nstring-upcase' operation on 'string'. A value of 0 starts the string at the beginning [no offset]. The ':end' keyword specifies the end offset for the operation on 'string'.

## Examples

    (nstring-upcase "ABcd+-12&[")                ; returns "ABCD+-&["
    (nstring-upcase "abcdefgh" :start 2 :end 4)  ; returns "abCDefgh"

    (setq mystr "ABcdEFgh")      ; set up variable
    (nstring-upcase mystr)       ; returns "ABCDEFGH"
    (print mystr)                ; prints  "ABCDEFGH"
                                 ; note that MYSTR is modified

See the nstring-upcase function in the XLISP 2.0 manual.

Back to Top

Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference