# uppercase

## Overview

The `uppercase` statement is used to set all letters in a variable or named buffer to upper case.

## Syntax

**`uppercase`***`var_name`*

**`uppercase`***`{buf_name}`* 

## Details

The single parameter to the `uppercase` statement determines whether or not the text to be normalised to upper case is located in a variable value or in a named buffer.

If the parameter starts and ends with `{` and `}` respectively then the text to be processed is in the named buffer identified by the contents of the curly braces. 

If not, then the text to be processed is the value of the variable named by the parameter.

## Examples

The following script:

```
var test = "123HellO WOrlD!!"
print ${test}

uppercase test
print Upper variable: ${test}

lowercase test
print Lower variable: ${test}

buffer testbuf = DATA "123HellO WOrlD!!"

uppercase {testbuf}
print Upper buffer: {testbuf}

lowercase {testbuf}
print Lower buffer: {testbuf}
```

... produces the following output:

```
=================================
USE: Unified Scriptable Extractor
=================================
123HellO WOrlD!!
Upper variable: 123HELLO WORLD!!
Lower variable: 123hello world!!
Upper buffer: 123HELLO WORLD!!
Lower buffer: 123hello world!!

USE script finished successfully

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://olddocs.exivity.io/data-pipelines/extract/language/uppercase.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.