Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


 

string ( string op string )

Comparison between two strings, returning either 0 (false) or 1 (true); op is one of the boolean operators below :

> Larger Than

< Smaller Than

>= Larger or Equal

<= Smaller or Equal

= Equal

<> Not Equal

...


Smaller, greater, equal applied to strings refer to lower, higher, same alphabetical order. The com­parison is case sensitive and is done using the ASCII code of each letter, hence the following expression is true (returns 1) :

...

Type man ascii at the UNIX prompt to know more about the ASCII encoding of characters.

...


string ( string & string & ... )
string ( string & number & ... )
string ( number & string & ... )
string ( string & date & ... )
string ( date & string & ... )

Returns a string equal to the concatenation of strings or strings and numbers and/or dates. If con­catenating a date, the date is first converted to a string using the default string date format.



Anchor
ascii
ascii

string ascii( number )

Returns a string consisting of one character whose ASCII code has been provided as the single parameter to the function. For example:

linefeed = ascii (10)


Anchor
length

...

length

number length( string )

This function returns the length of a string

word = "hello"
print (word " is ", length(word), "characters long")


Anchor
lowercase
lowercase

string lowercase( string )

Returns a lowercase copy of the input string.


Anchor
number
number
 

number number( string )

Converts a string into a number; if a string cannot be converted into a number, then  zero is returned. Example: a = number('123.4')


Anchor
parse
parse

list parse( string )
list parse( string,string )
list parse( string,string,string )

...

The parse() function is useful to parse text input when reading ASCII files within a macro program. Note that for ASCII data structured in columns (such as CSV files), Metview has some specific tools available - see ASCII Tables for more information.


Anchor
search

...

search

string search (string,string)

...

filename = 'z_t2m_u_v_20060717.grib'
t2m_index = search (filename, 't2m')

returns the value 3.


Anchor
substring

...

substring

string substring (string,number,number)

...

substring ("Metview", 2, 4)

returns the string "etv".


Anchor
string

...

string

string string( date,string )

...

  • yy gives 97

  • yyyy gives 1997

  • m gives 4

  • mm gives 04

  • mmm gives Apr

  • mmmm gives April

  • d gives 1

  • dd gives 01

  • ddd gives Tue

  • dddd gives Tuesday

  • D gives 91 (4th of April = julian day 91; 92 for a leap year).

  • DDD gives 091

  • H gives 2

  • HH gives 02

  • M gives 3

  • MM gives 03

  • S gives 4

  • SS gives 04

  • Any other character is copied as such.


Anchor
uppercase
uppercase

string uppercase( string )

Returns an uppercase copy of the input string.

...