Gambas Documentation
Application Repository
Code Snippets
Compilation & Installation
Components
gb
*[]
.Array.Bounds
.Stat.Perm
.Stream.Lines
.Stream.Term
.Symbol
_BoxedString
Application
Args
Array
Boolean[]
Byte[]
Class
Classes
Collection
Component
Components
Date[]
Enum
Env
Error
File
Float[]
gb
Integer[]
Jit
Long[]
Object
Object[]
_get
_new
_next
_put
Add
Copy
Delete
Exist
ExistByRef
ExistByRefSorted
ExistSorted
Extract
Fill
Find
FindByRef
FindByRefSorted
FindSorted
First
Insert
Last
Pop
Push
Reverse
Sort
SortUsing
Observer
Param
Pointer[]
Process
Short[]
Single[]
Stat
Stream
String
String[]
System
Task
Timer
User
Variant[]
gb.args
gb.cairo
gb.chart
gb.clipper
gb.complex
gb.compress
gb.crypt
gb.data
gb.db
gb.db.form
gb.db.mysql
gb.db.odbc
gb.db.postgresql
gb.db.sqlite2
gb.db.sqlite3
gb.dbus
gb.dbus.trayicon
gb.debug
gb.desktop
gb.desktop.gnome.keyring
gb.desktop.x11
gb.eval
gb.eval.highlight
gb.form
gb.form.dialog
gb.form.editor
gb.form.htmlview
gb.form.mdi
gb.form.print
gb.form.stock
gb.form.terminal
gb.gmp
gb.gsl
gb.gtk
gb.gtk.opengl
gb.gtk3
gb.gtk3.opengl
gb.gtk3.webview
gb.gui
gb.gui.opengl
gb.gui.qt
gb.gui.qt.ext
gb.gui.qt.opengl
gb.gui.qt.webkit
gb.gui.trayicon
gb.gui.webview
gb.hash
gb.highlight
gb.image
gb.image.effect
gb.image.imlib
gb.image.io
gb.inotify
gb.jit
gb.libxml
gb.logging
gb.map
gb.markdown
gb.media
gb.media.form
gb.memcached
gb.mime
gb.mysql
gb.ncurses
gb.net
gb.net.curl
gb.net.pop3
gb.net.smtp
gb.openal
gb.opengl
gb.opengl.glsl
gb.opengl.glu
gb.opengl.sge
gb.openssl
gb.option
gb.pcre
gb.pdf
gb.poppler
gb.qt4
gb.qt4.ext
gb.qt4.opengl
gb.qt4.webkit
gb.qt4.webview
gb.qt5
gb.qt5.ext
gb.qt5.opengl
gb.qt5.webkit
gb.qt5.webview
gb.qt6
gb.qt6.ext
gb.qt6.opengl
gb.qt6.webview
gb.report
gb.report2
gb.scanner
gb.sdl
gb.sdl.sound
gb.sdl2
gb.sdl2.audio
gb.settings
gb.signal
gb.term
gb.test
gb.util
gb.util.web
gb.v4l
gb.vb
gb.web
gb.web.feed
gb.web.form
gb.web.gui
gb.xml
gb.xml.html
gb.xml.rpc
gb.xml.xslt
Controls pictures
Deprecated components
Developer Documentation
Development Environment Documentation
Documents
Error Messages
Gambas Playground
How To's
Language Index
Language Overviews
Last Changes
Lexicon
README
Search the wiki
To Do
Topics
Tutorials
Wiki License
Wiki Manual

Object[] (gb)

This class implements a dynamic array of Object references.

This class inherits Array.

This class is creatable.

This class acts like a read / write array.

This class is enumerable with the FOR EACH keyword.

Properties
First   Return or set the first element of the array.
Last   Return or set the last element of the array.

Inherited properties
Bounds   Returns a virtual class representing the bounds of each array dimension.
Count   Returns the number of elements in the array.
Data   Returns a pointer to the array data.
Dim   Returns the number of dimensions of an array.
Empty   Return if the array is empty.
Length   Returns the number of elements in the array.
Max   Returns the greatest index of the array.
ReadOnly   Return or set if the array contents is read-only.
Type   Returns the type of data that can be put into the array.

Methods
Add   Inserts an element into the array at the position specified by Index.
Copy   Returns a deep copy of the array.
Delete   A synonymous for Extract.
Exist   Return if the specified object exists in the array.
ExistByRef   Check if a specific object is stored in the array.
ExistByRefSorted   Return the position of the first occurrence of a specific object in the array.
ExistSorted   Return if the specified object exists in the array.
Extract   Removes one or more elements from the array, and returns them.
Fill   Fills the array with the specified value.
Find   Returns the position of the first occurrence of Value in the array.
FindByRef   Return the position of the first occurrence of a specific object in the array.
FindByRefSorted   Return the position of the first occurrence of a specific object in the array.
FindSorted   Returns the position of the first occurrence of Value in the array.
Insert   Insert an array into the current one at the position specified by Pos.
Pop   Removes the last element of the array and returns it.
Push   Adds an element at the end of the array.
Reverse   Reverse the order of array elements, and return the array.
Sort   Sort the array and return it.
SortUsing   Sort the array using the order defined by the Order array.

Inherited methods
Clear   Clears the array.
Remove   Removes one or more elements from the array.
Resize   Resizes the array.
Shuffle   Randomly shuffle the array using the Fisher–Yates algorithm.

Example

This example shows how to create an array of TextBoxes

PUBLIC aobjDisplay AS NEW Object[9, 9]

PUBLIC SUB Form_Open()
DIM r AS Integer
DIM c AS Integer
DIM objTextBox AS TextBox

FOR r = 0 TO 8
    FOR c = 0 TO 8
      objTextBox = NEW TextBox(ME) ' create the next of the 9*9 TextBoxes
      objTextBox.= 9 + r * 40
      objTextBox.= 9 + c * 40
      objTextBox.Width = 32
      objTextBox.Height = 32
      aobjDisplay[r, c] = objTextBox
    NEXT '    c
  NEXT '      r
END