Available on:

UBOUND

The UBOUND command (short for "upper bound") is used to determine the highest index of an array. In other words, it tells you how far up the array goes.

Imagine you have a box of numbered chocolates. UBOUND tells you what the number of the last chocolate is. This is useful when you need to iterate over all the elements of an array, because it gives you the end point of the loop.

UBOUND and LBOUND are often used together to define the bounds of a FOR loop, and are complementary commands: they allow you to obtain complete information about the structure of an array. Knowing these two values, you can iterate over all the elements of the array, calculate its total size, and perform many other operations.

SYNTAX

 = UBOUND( array [, dimension])


Legend
  • id : identifier
  • type : datatype
  • v : value
  • "..." : string
  • [...] : optional

EXAMPLE

 DIM a(10,20)
 PRINT UBOUND(a,1) : REM it will print 20


ABBREVIATION: Ub

Join BASIC 10Liner Contest with ugBASIC!

An interesting competition is held at the beginning of each year: the BASIC 10Liner Contest. It is possible to use ugBASIC to participate in the next "BASIC10Liner" competition, in the following categories:

  • PUR-120 - A game in 10 lines of max 120 characters (w/abbrev.)
  • EXTREME-256 - A game in 10 lines of max 256 characters (w/abbrev.)
  • SCHAU - Any program in 10 lines of max 256 characters (w/abbrev.)
In order to reduce space you can use this abbreviation for this instruction:

UBOUND ↔ Ub

Any problem?

If you have found a problem with this keyword, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO KEYWORDS