འགྱུར་ཅན་ཚུ་ལག་ལེན་འཐབ་དོ།

Contents

# འགྱུར་ཅན་ལག་ལེན་འཐབ་དོ་

འོག་གི་འདི་གིས་LibreOffice གཞི་རྟེན་ནང་གི་འགྱུར་ཅན་ཚུའི་ལག་ལེན་གཞི་རྟེན་འདི་འགྲེལ་བཤད་འབདཝ་ཨིན།

## འགྱུར་ཅན་ངོས་འཛིན་པ་ཚུའི་དོན་ལུ་གཞི་བསྒྱུར་་ཚུ་མིང་བཏགས་དོ།

འགྱུར་ཅན་མིང་ཅིག་ལུ་ཡིག་འབྲུ་ཚུ་ ༢༢༥འི་ ཉུང་མཐའ་རིམ་མཐུན་འབདཝ་ཨིན། འགྱུར་ཅན་མིང་གི་ཡིག་འབྲུ་དང་པམ་ འདི་ ཡིག་གུ་ A-Z ཡང་ན་ a-z འོང་དགོཔ་ཨིན། ཨང་གྲངས་འདི་ཡང་འགྱུར་ཆན་མིང་ནང་ལག་ལེན་འཐབ་བཏུབ་ཨིན་ ཨིན་རུང་ ཡིག་རྟགས་མདའ་མཚོན་ཚུ་དང་ཡིག་འབྲུ་ཚུ་ གཤམ་ཐིག་ཡིག་འབྲུ་འདིའི་དམིགས་བསལ་དང་ཅིག་ཁར་ མི་ཆོགཔ་ཨིན།("_"). LibreOffice ནང་ལུ་གཞི་རིམ་འགྱུར་ཅན་ངོས་འཛིན་པ་ཚུ་ཆ་མཉམ་ཡིག་གུ་ཆེ་ཆུང་གི་ཉེན་ཁ་མེན། འགྱུར་ཅན་མིང་ཚུའི་ནང་ན་བར་སྟོང་ཡོདཔ་ཨིན་རུང་ཁོང་ཆ་ཁྱབ་གུག་ཤད་གྲུ་བཞི་ནང་ཚུད་དགོཔ་ཨིན།

ངོས་འཛིན་འབད་མི་ཚུའི་འགྱུར་ཅན་དོན་ལུ་དཔེར་བརྗོད་ཚུ།

        MyNumber=5      'Correct'
        MyNumber5=15    'Correct'
        MyNumber_5=20   'Correct'
        My Number=20    'Not valid, variable with space must be enclosed in square brackets'
        [My Number]=12  'Correct'
        DéjàVu=25       'Not valid, special characters are not allowed'
        5MyNumber=12    'Not valid, variable may not begin with a number'
        Number,Mine=12  'Not valid, punctuation marks are not allowed'

## འགྱུར་ཅན་ཚུ་གསལ་བསྒྲགས་འབད་དོ།

LibreOffice གཞི་རིམ་ནང་ཁྱོད་ཀྱིས་འགྱུར་ཅན་ཚུ་གཏན་ཁེལ་གསལ་བསྒྲགས་འབད་མི་དགོ འགྱུར་ཅན་གསལ་བསྒྲགས་འདི་ Dimགསལ་བཤད་ཅིག་ཁར་ལཱ་འགན་འགྲུབ་བཏུབ། ཁྱོད་ཀྱིས་འགྱུར་ཅན་གཅིག་ལས་ལྷགཔ་མིང་འདི་ལྷོད་རྟགས་ཀྱིས་དབྱེ་སེལ་འབད་འདི་གསལ་བསྒྲགས་འབད་བཏུབ། འགྱུར་ཅན་དབྱེ་བ་འདི་ངེས་འཛིན་འབད་ནི་ལུ་ མིང་འདིའི་ཤུལ་མ་དབྱེ་བ་གསལ་བསྒྲགས་རྟགས་འདི་འབད་རུང་ ཡང་ན་གཙོ་ཚིག་འོས་ལྡན་འདི་ལག་ལེན་འཐབ།

འགྱུར་ཅན་གསལ་བསྒྲགས་ཚུའི་དོན་ལུ་དཔེར་བརྗོད་ཚུ:

        Dim a$               'Declares the variable "a" as a String'
        Dim a As String      'Declares the variable "a" as a String'
        Dim a$, b As Integer 'Declares one variable as a String and one as an Integer'
        Dim c As Boolean     'Declares c as a Boolean variable that can be TRUE or FALSE'

ཚར་གཅིག་ཁྱོད་ཀྱིས་འགྱུར་ཅན་ངེས་ཅན་དབྱེ་བ་བཟུམ་སྦེ་གསལ་བསྒྲགས་འབད་ཚར་ཞིནམ་ལས་ ཁྱོད་ཀྱིས་འགྱུར་ཅན་འདི་མིང་ཅོག་འཐདཔ་ལོག་སོ་སོ་དབྱེ་བ་བཟུམ་སྦེ་གསལ་བསྒྲགས་འབད་བཏུབ།

When you declare multiple variables in a single line of code you need to specify the type of each variable. If the type of a variable is not explicitly specified, then Basic will assume that the variable is of the Variant type.

      ' Both variables "a" and "b" are of the Integer type
      Dim a As Integer, b As Integer
      ' Variable "c" is a Variant and "d" is an Integer
      Dim c, d As Integer
      ' A variable can also be explicitly declared as a Variant
      Dim e As Variant, f As Double

The Variant type is a special data type that can store any kind of value. To learn more, refer to the section The Variant type below.

### འགྱུར་ཅན་གསལ་བསྒྲགས་ཚུ་བང་བཙོང་དོ།

འགྱུར་ཅན་ཚུའི་་གསལ་བསྒྲགས་བང་བཙོང་ནི་དོན་ལུ་ འོག་གི་བརྡ་བཀོད་ལག་ལེན་འཐབ:

    Option Explicit

གདམ་ཁ་གཏན་ཁེལ་ གསལ་བཤད་འདི་ ཚད་གཞི་ནང་འོག་མ་དང་པ་གི་ཧེ་མ་་གྱལ་དང་པ་སྦེ་འོང་གོ། ཡོངས་ཁྱབ་ཀྱི་ཨེ་རེ་ཚུ་རྐྱངམ་ཅིག་གཏན་ཁེལ་གསལ་བསྒརགས་འབད་དགོཔ་ཨིན། གཞན་འགྱུར་ཅན་ཚུ་ཆ་མཉམ་ཡིག་འབྲུ་དབྱེ་བ་གསལ་བསྒྲགས་ལྟར་དུ་གསལ་བསྒྲགས་འབད་ཡོདཔ་ཨིན་ ཡང་ན་ སྐྱུར་བཞག་ཨིན་པ་ཅིན་སྔོན་སྒྲིག་དབྱེ་བ་\རྐྱང་པ་བཟེམ་སྦེ་ཨིན།.

## འགྱུར་ཅན་དབྱེ་བ་ཚུ།

LibreOffice གཞི་རྟེན་གྱིས་འགྱུར་ཅན་དབྱེ་རིགས་བཞི་རྒྱབ་སྐཡོར་འབདཝ་ཨིན:

- ཨང་གྲངས་ཀྱི་ འགྱུར་ཅན་ཚུའི་ནང་ན་ཨང་གི་གནས་གོང་ཚུ་ཡོདཔ་ཨིདན། འགྱུར་ཅན་ཚུ་ལ་ལོ་ཅིག་ཨང་གྲངས་སྦོམ་ཡང་ན་ཆུང་ཀུ་ཚུའི་མཛོད་ཁང་སྦེ་ལག་ལེན་འཐབ་ཡོདཔ་དང གཞན་ཚུ་ཆ་མཉམ་ལྡིང་ཚད་ཡང་ན་ དཔྱ་ཕྲན་ཨང་ཚུའི་དོན་ལུ་ལག་ལེན་འཐབ་ཡོདཔ་ཨིན།

- String འགྱུར་ཅན་ཚུ་ནང་ན་ཡིག་འབྲུ་ཡིག་རྒྱུན་ཚུ་ཡོདཔ་ཨིན།

- Boolean འགྱུར་ཅན་ཚུའི་ནང་ན་བདེན་པ་ཡང་ན་རྫུན་མའི་གནས་གོང་ཡོད།

- Object འགྱུར་ཅན་ཚུའི་ནང་ན་དངོས་པོའི་དབྱེ་བ་འདྲ་མིན་སྣ་ཚོགས་ དེ་བཟུམ་སྦེ་ཐིག་ཁྲམ་ཚུ་དང་ཡིག་ཆ་ཚུའི་ནང་འཁོད་ཡིག་ཆ་ཚུད་ཡོད།

### ཧྲིལ་ཨང་འགྱུར་ཅན་ཚུ།

ཧྲིལ་ཨང་འགྱུར་ཅན་ཚུ་ཁྱབ་ཚད་ ༣༢༧༦༨་ ལས་༣༢༧༦༧་ ལུ་ཨིན། ཁྱོད་ཀྱིས་ཧྲིལ་ཨང་འགྱུར་ཅན་ཅིག་ལུ་འཕུར་ལྡིང་ཚད་ཅིག་ལུ་འགན་སྤྲོད་པ་ཅིན་བཅུ་ཚག་གནས་ཁོངས་ཚུ་ཆ་མཉམ་ཧྲིལ་ཨང་ཤུལ་མམ་འདི་ལུ་སྐོར་ཐེངས་ཡོདཔ་ཨིན། ཧྲིལ་ཨང་འགྱུར་ཅན་ཚུ་ཆ་མཉམ་འཕྲལ་བཀོལ་ཚུ་ནང་་གདོང་ལེན་འགྱུར་ཅན་ཚུའི་དོན་ལུ་ཆ་མཉམ་འོས་འབབ་དང་བྱ་སྒོའི་ལམ་ལུགས་ཚུ་ནང་མགྱོགས་པ་རཙིས་སྟོན་ཡོདཔ་ཨིན། ཧྲིལ་ཨང་འགྱུར་ཅན་དྲན་ཚད་ཀྱི་བཱའིཊིསི་ཁཉིས་རྐྱངམ་ཅིག་དགོ་མཁོ་ཡོདཔ་ཨིན། "%" འདི་ཡིག་འབྲུ་གསལ་བསྒྲགས་དབྱེ་བ་འདི་ཨིན།

    Dim Variable%
    Dim Variable As Integer

### ཧྲིལ་ཨང་འགྱུར་ཅན་ཚུ་རིངམ།

ཧྲིལ་ཨང་འགྱུར་ཅན་རིངམ་ཚུའི་ཁྱབ་ཚད་ ༢༡༤༧༨༣༦༤༨་ལས་༢༡༤༧༤༨༣༦༤༧་ ལུ་ཨིན། ཁྱོད་ཀྱིས་ཧྲིལ་ཨང་འགྱུར་ཅན་རིངམ་ལུ་འཕུར་ལྡིང་ཚད་ཅིག་འགན་སྤྲོད་པ་ཅིན་བཅུ་ཚག་གནས་ཁོངས་ཚུ་ཆ་མཉམ་ཧྲིལ་ཨང་ཤུལ་མམ་ལུ་སྐོར་ཐེངས་ཡོདཔ་ཨིན། ཧྲིལ་ཨང་འགྱུར་ཅན་རིངམཚུ་ཆ་མཉམ་ཆེ་བ་གནས་གོང་ཚུའི་དོན་ལུ་འཕྲལ་བཀོལ་ཚུ་ནང་གདོང་ལེན་འགྱུར་ཅན་ཚུའི་དོན་ལུ་འོས་འབབ་ཨིནམ་དང་བྱ་སྒོའི་ལམ་ལུགས་ཚུ་ནང་ཆ་མཉམ་མགྱོས་པ་་རྩིས་སྟོན་ཡོདཔ་ཨིན། ཧྲིལ་ཨང་འགྱུར་ཅན་རིངམ་ལུ་དྲན་ཚད་ཀྱི་བཱའིཊིསི་བཞི་དགོ་མཁོ་ཡོདཔ་ཨིན། "&" འདི་ཡིག་འབྲུ་གསལ་བསྒྲགས་དབྱེ་བ་ཨིན།

    Dim Variable&
    Dim Variable As Long

### Decimal Variables

Decimal variables can take positive or negative numbers or zero. Accuracy is up to 29 digits.

You can use plus (+) or minus (-) signs as prefixes for decimal numbers (with or without spaces).

If a decimal number is assigned to an integer variable, LibreOffice Basic rounds the figure up or down.

### འགྱུར་ཅན་ཚུ་རྐྱང་པ།

Single variables can take positive or negative values ranging from 3.402823 x 10E38 to 1.401298 x 10E-45. Single variables are floating-point variables, in which the decimal precision decreases as the non-decimal part of the number increases. Single variables are suitable for mathematical calculations of average precision. Calculations require more time than for Integer variables, but are faster than calculations with Double variables. A Single variable requires 4 bytes of memory. The type-declaration character is "!".

    Dim Variable!
    Dim Variable As Single

### ལོག་བལྟབ་འགྱུར་ཅན་ཚུ།

Double variables can take positive or negative values ranging from 1.79769313486232 x 10E308 to 4.94065645841247 x 10E-324. Double variables are floating-point variables, in which the decimal precision decreases as the non-decimal part of the number increases. Double variables are suitable for precise calculations. Calculations require more time than for Single variables. A Double variable requires 8 bytes of memory. The type-declaration character is "#".

    Dim Variable#
    Dim Variable As Double

### དངུལ་འགྱུར་ཅན་ཚུ།

དངུལ་འགྱུར་ཅན་ཚུ་ཆ་མཉམ་ ༦༤་ བི་ཊི་ ཨང་ཚུ་ (8 Bytes) སྦེ་གསོག་འཇོག་འབད་ཡོདཔ་ དང་ གཏན་བཟོ་བཅུ་ཚག་ཨང་བཅས་ ༡༥་ བཅུ་ཚག་མེནམ་དང་ ༤ བཅུ་ཚག་ས་གནས་ཚུ་སྦེ་བཀྲམ་བཏོན་འབད་ཡོདཔ་ཨིན། གནས་གོང་ཚུ་་ ༩༢༢༣༣༧༢༠༣༦༨༥༤༧༧་ ༥༨༠༨ +༩༢༢༣༣༧༢༠༣༦༨༥༤༧༧་ ༥༨༠༧ ལུ་ཁྱབ་ཚད་འདི་ཡོདཔ་ཨིན། དངུལ་འགྱུར་ཅན་ཚུ་ཆ་མཉམ་དངུལ་གནས་གོང་བཅས་མཐོ་ཀྲིག་ཀྲི་རྩིས་སྟོན་ནི་ལུ་ལག་ལེན་འཐབ་ཡོདཔ་ཨིན། དབྱེ་བ་གསལ་བསྒྲགས་ཡིག་འབྲུ་འདི་ "@"་ཨིན།

    Dim Variable@
    Dim Variable As Currency

### Literals for integers

Numbers can be encoded using octal and hexadecimal forms.

      xi = &o13 '    8 + 3
      ci = &h65 ' 6*16 + 5
      MAX_Integer =  &o77777 '  32767 = &h7FFF
      MIN_Integer = &o100000 ' -32768 = &h8000
      MAX_Long = &h7fffffff '  2147483647 = &o17777777777
      MIN_Long = &h80000000 ' -2147483648 = &o20000000000

### ཡིག་རྒྱུན་འགྱུར་ཅན་ཚུ།

String variables can hold character strings with up to 2,147,483,648 characters. Each character is stored as the corresponding Unicode value. String variables are suitable for word processing within programs and for temporary storage of any non-printable character up to a maximum length of 2 Gbytes. The memory required for storing string variables depends on the number of characters in the variable. The type-declaration character is "$".

In BASIC String functions, the first character of the string has index 1.

    Dim Variable$
    Dim Variable As String

### བུ་ལིན་འགྱུར་ཅན་ཚུ།

བུ་ལིན་འགྱུར་ཅན་ཚུ་གནས་གོང་གཉིས་གྱི་གཅིག་རྐྱངམ་ཅིག་གསོག་འཇོག་འབདཝ་ཨིན: བདེན་པ་ཡང་ན་རྫུན་མ། ཨང་གྲངས་ ༠་ གཅིག་རྫུན་མ་ལུ་ཞིབ་དཔྱད་འབདཝ་ཨིན གཞན་གནས་གོང་རེ་རེ་བདེན་པ་ལུ་ཞིབ་དཔྱད་འབདཝ་ཨིན།

    Dim Variable As Boolean

### ཚེས་འགྱུར་ཅན་ཚུ།

ཚེས་འགྱུར་ཅན་ཚུའི་ནང་ན་ཚེས་ཚུ་རྐྱངམ་ཅིག་དང་དུས་འཛིན་འགྱུར་ཅན་ཚུ་རྩ་སྒྲིག་ནང་འཁོད་ནང་གསོག་འཇོག་ཡབད་ཡཅདཔ་ཨིན། ཚེས་འགྱུར་ཅན་ཚུ་དང་ཅིག་ཁར་འགཔ་སྤྲོད་ཡོད་མི་གནས་གོང་ཚུ་ ཚེས་རིམ་ཨང་ལུ་, ཚེས་གནས་གོང་, དུས་འཛིན་རིམ་ཨང་ ཡང་ན་ དུས་འཛིན་གནས་གོང་ ཆ་མཉམ་རང་བཞིན་གྱིས་རྩ་སྒྲིག་ནང་འཁོད་ལུ་གཞི་བསྒྱུར་འབད་ཡོདཔ་ཨིན། ཚེས་འགྱུར་ཅན་ཚུ་ཆ་མཉམ་ སྤྱིར་བཏང་ཨང་གྲངས་ལུ་ཉིནམ་, ཟླ, ལོ ཡང་ན་ ཆུ་ཚོད་, སྐར་མ, སྐར་ཆག་ ལས་འགན་འདི་ལག་ལེན་འཐབ་འདི་གཞི་བསྒྱུར་འབདཝ་ཨིན། རྩ་སྒྲིག་ནང་འཁོད་འདི་གིས་ ཚེས/དུས་འཛིན་གྱི་ག་བསྡུར་གནས་གོང་ཚུ་ཨང་གཉིས་ཀྱི་སྦུག་ནང་སོ་སོ་རྩིས་སྟོན་འདི་ལྕོགས་ཅན་བཟོཝ་ཨིན།་ འ་ནི་འགྱུར་ཅན་ཚུ་རྐྱངམ་ཅིག་གཙོ་ཚིག་དང་གཅིག་ཁར་ ཚེས་གསལ་བསྒྲགས་འབད་བཏུབ་ཨིན།

    Dim Variable As Date

### Literals for Dates

Date literals allow to specify unambiguous date variables that are independent from the current language. Literals are enclosed between hash signs #. Possible formats are:

- #yyyy-mm-dd#

- #mm/dd/yyyy#

      start_date = #12/30/1899# ' = 1
      dob = #2010-09-28#

## The Variant type

Variables declared as Variant can handle any data type. This means that the actual data type is defined during runtime as a value is assigned to the variable.

There are three main ways to create a Variant variable, as shown below:

      Dim varA            ' The type is not specified, hence the variable is a Variant
      Dim varB as Variant ' The variable is explicitly declared as a Variant
      varC = "abc"        ' Previously undeclared variables are treated as Variants

The example below uses the TypeName function to show how the type of a Variant variable changes upon assignment.

      Dim myVar As Variant
      MsgBox TypeName(myVar) ' Empty
      myVar = "Hello!"
      MsgBox TypeName(myVar) ' String
      myVar = 10
      MsgBox TypeName(myVar) ' Integer

A Variant variable is initialized with the Empty special data type. You can use the IsEmpty function to test if a variable is an Empty Variant.

You can also use the keyword Any to declare a variable as a Variant. However, Any is deprecated and is available for backward compatibility.

Arguments with type Variant or Any passed in function calls are not checked for their types.

      Dim myVar As Any ' Variable "myVar" is a Variant

## འགོ་ཐོག་འགྱུར་ཅན་གནས་གོང་ཚུ།

འགྱུར་ཅན་འདི་མགྱོགས་པ་རང་གསལ་བསྒྲགས་འབད་ཚརཝ་ཅིན་ ཁོ་ར་རང་བཞིན་གྱིས་ "Null"གནས་གོང་ལུ་གཞི་སྒྲིག་འབདཝ་ཨིན། . འོག་གི་གཞི་བསྒྱུར་འདི་དྲན་དགོཔ:

ཨང་གྲངས་ཀྱི་ འགྱུར་ཅན་ཚུ་ཆ་མཉམ་རང་བཞིན་གྱིས་ "0" གནས་གོང་འདི་་ ཁོང་་ཆ་མཉམ་མགྱོགས་པ་རང་གསལ་བསྒྲགས་འབད་ཚརཝ་ཅིན་འགན་སྤྲོད་ཡོདཔ་ཨིན།

ཚེས་འགྱུར་ཅན་ཚུ་ ཆ་མཉམ་གནས་གོང་ ༠་ ནང་འཁོད་འགན་སྤྲོདཔ་ཨིན གནས་གོང་ལུ་ "0" གཞི་བསྒྱུར་ལུ་འདྲ་མཉམ་་དང་གཅིག་ཁར་ ཉིནམ་, ཟླ་, ལོ་ ཡང་ན་ ཆུ་ཚོད་, སྐར་མ, སྐར་ཆག་ ལས་འགན་ལུ་གཞི་བསྒྱུར་འབདཝ་ཨིན།

ཡིག་རྒྱུན་འགྱུར་ཅན་ཚུ་ ཆ་མཉམ་ཡིག་རྒྱུན་སྟོངམ་ཅིག ("") ཁོང་ཆ་མཉམ་གསལ་བསྒྲགས་འབད་བའི་སྐབས་འགན་སྤྲོད་ཡོདཔ་ཨིན།

## ཨེ་རིསི།

LibreOffice གཞི་རིམ་གྱིས་གཅིག་ ཡང་ན་སྣ་མང་ མཚོན་གྲངས་ཨེ་རེསི་ འགྱུར་ཅན་དབྱེ་བ་གསལ་བཀོད་ཡོདཔ་གིས་ངེས་འཛིན་འབད་ཡོདཔ་ཤེསཔ་ཨིན། ཨེ་རེ་ཚུ་ཆ་མཉམ་ཐཅ་ཡིག་ཚུ་ཞུན་དག་འབད་ནི་དང་ལས་རིམ་ཚུ་ནང་ཐིག་ཁྲམ་ཚུའི་དོན་ལུ་འོས་འབབ་ཡོདཔ་ཨིན། རྒྱུ་རྫས་ཚུ་ངོ་རྐྱང་གི་ཨེ་རེ་འདི་ཨང་གྲངས་ཀྱི་ཟུར་ཐོ་བརྒྱུད་དེ་ཁ་བྱང་བཏགས་བཏུབ་ཨིན།

ཨེ་རིསི་ འདི་ མདངས་གྲིབ་ གསལ་བཤད་ གཅིག་ཁར་གསལ་བསྒྲགས་འབད་དགོཔ་ཨིན། ཨེ་རི་གི་ཟུར་ཐོ་ཁྱབ་ཚད་ངེས་འཛིན་འབད་ནི་ལུ་ཐབས་ལམ་ཚུ་ལེ་ཤ་ཡོདཔ་ཨིན:

        Dim Text$(20)       '21 elements numbered from 0 to 20'
        Dim Text$(5,4)      '30 elements (a matrix of 6 x 5 elements)'
        Dim Text$(5 To 25)  '21 elements numbered from 5 to 25'
        Dim Text$(-15 To 5) '21 elements (including 0), numbered from -15 to 5'

ཁྱབ་ཚད་ཟུར་ཐོ་འདི་གིས་ཡོད་ཆ་བཟུམ་སྦེ་མེད་ཆའི་ཨང་གྲངས་ཚུ་ཡང་གྲངས་སུ་བཙུགས་བཏུབ།

## ཆད་མེད་ཚུ།

ཆད་མེད་ཚུ་གནས་གོང་གཏན་བཟོ་ཡོདཔ། ཁོང་ཆ་མཉམ་ལས་རིམ་ནང་ལུ་ཚར་གཅིག་རྐྱངམ་ཅིག་ངེས་འཛིན་འབད་བཏུབ་དང་ཤུལ་ལས་བསྐྱར་ངེས་འཛིན་འབད་མི་བཏུབ:

    Const ConstName=Expression

འབྲེལ་བ་ཡོད་པའི་གནད་དོན།

Basic Constants

Dim Statement