Windows için RexxUtil Kütüphanesi - İşlevler - SysIni
    =====================================================

    Dizilim
    -------

         sonuc = SysIni(dosya, uygulama, anahtar, değer, kulp)

         Call SysIni dosya, uygulama, anahtar, değer, kulp

    İşlev
    -----

         Başlangıç ayarlarını içeren dosyalardaki belgi
         bilgisine ve bu bilgileri içeren değişkenlere 
         sınırlı bir şekilde erişilmesini sağlar.

    Değiştirge(ler)
    ---------------

         dosya
         ^^^^^

              Üzerinde işlem yapılacak ve uzantısı "INI" dizgisi olan
              başlangıç ayarları dosyasının adı ya da tam-yol
              bulunağı. Varsayılan değer, "WIN.INI" dosyasıdır.

         uygulama
         ^^^^^^^^

              Belgi bilgisini depolamak amacıyla kullanılacak
              uygulamayı tanımlayan dizgi.

         anahtar
         ^^^^^^^

              Belgi bilgisini hareketlendirmek amacıyla kullanılacak
              anahtar kelimeyi içeren dizgi.

         değer
         ^^^^^

              Uygulama anahtar kelimesinin değeri.

         kulp
         ^^^^

              Belgi bilgisinin depolanacağı ve dizinli değişken.
              "kulp.0", dönen değerlerin toplam sayısını işaret
              eder.

    Dönüş Değer(ler)i
    -----------------

         "sonuc" değiştirgesi ya da "RESULT" özel değişkeni
         yardımıyla elde edilebilecek olası değerler ve
         anlamları,

              Boş Dizgi : İşlem başarılı.

              ERROR:    : İşlemde bir hata oluştu. Oluşan hata
                          bu dizginin devamına yazılır. Olası
                          hatalar,

                          *    Uygulama ya da anahtar mevcut değil.

                          *    Dosyanın açılmasında hata var.

                          şeklinde tanımlanan nedenlerden dolayı
                          kaynaklanabilir.

         şeklinde tanımlıdır.

    Örnek Kullanım
    --------------

         /* --- Düzgü-1 --- */
         Call SysIni 'WIN.INI', 'ALL', 'Apps'     /* Kulp = Apps */
         If RESULT = 'ERROR:' Then
            Do i = 1 To Apps.0
               Call SysIni 'WIN.INI', Apps.i, 'ALL', 'Keys'    /* Kulp = Keys */
               If RESULT = 'ERROR:' Then
                  Do j = 1 To Keys.0
                     val = SysIni('WIN.INI', Apps.i, Keys.j)
                     Say LEFT(Apps.i, 20) LEFT(Keys.j, 20),
                         'Uzunluk=x'LEFT(D2X(LENGTH(val)), 4) LEFT(val, 20)
                  End
            End
         Exit

    Açıklama(lar)
    -------------

         *    SysIni işlevine ait 6 tane kip dizilimi vardır. Söz
              konusu kip dizilimlerinin tanımları ve ilintili
              dizilimleri

              o    Bir Anahtar Değerinin Atanması

                   SysIni(dosya, uygulama, anahtar, değer)

                   Call SysIni dosya, uygulama, anahtar, değer

              o    Bir Anahtar Değerinin Elde Edilmesi

                   SysIni(dosya, uygulama, anahtar)

                   Call SysIni dosya, uygulama, anahtar

              o    Bir Anahtar Değerinin Silinmesi

                   SysIni(dosya, uygulama, anahtar, 'DELETE:')

                   Call SysIni dosya, uygulama, anahtar, 'DELETE:'

              o    Bir Uygulamanın ve İlintili Anahtarların Silinmesi

                   SysIni(dosya, uygulama, 'DELETE:')

                   Call SysIni dosya, uygulama, 'DELETE:'

              o    Bir Uygulamaya Ait Tüm Anahtarların Elde Edilmesi

                   SysIni(dosya, uygulama, 'ALL:', kulp)

                   Call SysIni dosya, uygulama, 'ALL:', kulp

              o    Tüm Uygulama İsimlerinin Elde Edilmesi

                   SysIni(dosya, 'ALL:', kulp)

                   Call SysIni dosya, 'ALL:', kulp

              şeklinde tanımlıdır.

    İçindekiler | İşlevler