g.messagegrass - Online di Cloud

PROGRAM:

NAMA

g.pesan - Mencetak pesan, peringatan, info kemajuan, atau kesalahan fatal dengan cara GRASS.
Modul ini harus digunakan dalam skrip untuk pesan yang disajikan kepada pengguna.

KEYWORDS

umum, dukungan, skrip

RINGKASAN

g.pesan
g.pesan --membantu
g.pesan [-wedpiv] pesan=string [men-debug=bilangan bulat] [--membantu] [--bertele-tele] [--tenang]
[--ui]

Bendera:
-w
Cetak pesan sebagai peringatan

-e
Pesan cetak sebagai kesalahan fatal

-d
Cetak pesan sebagai pesan debug

-p
Cetak pesan sebagai info kemajuan

-i
Cetak pesan dalam semua mode kecuali mode senyap
Pesan dicetak di GRASS_VERBOSE>=1

-v
Cetak pesan hanya dalam mode verbose
Pesan hanya dicetak di GRASS_VERBOSE>=3

--membantu
Cetak ringkasan penggunaan

--bertele-tele
Keluaran modul verbose

--diam
Keluaran modul yang tenang

--ui
Paksa meluncurkan dialog GUI

Parameter:
pesan=string [yg dibutuhkan]
Teks pesan yang akan dicetak
Pesan dicetak di GRASS_VERBOSE>=2

men-debug=bilangan bulat
Level yang digunakan untuk pesan debug
Pilihan: 0-5
Default: 1

DESKRIPSI

Program ini akan digunakan dalam skrip Shell/Perl/Python, jadi penulis tidak perlu
menggunakan program gema. Keuntungan dari g.pesan apakah itu memformat pesan seperti
yang dilakukan modul GRASS lainnya dan fungsinya dipengaruhi oleh GRASS_VERBOSE dan
Variabel lingkungan GRASS_MESSAGE_FORMAT.

Program ini dapat digunakan untuk pesan informatif standar serta peringatan (-w bendera)
dan kesalahan fatal (-e bendera). Untuk tujuan debugging, -d bendera akan menyebabkan g.pesan untuk
mencetak pesan debug pada tingkat yang diberikan.

CATATAN

Pesan yang mengandung "=" harus menggunakan full pesan= sintaks sehingga parser tidak mendapatkan
bingung.

Jika Anda ingin pesan panjang (multi-baris) ditangani sebagai satu paragraf, gunakan a
panggilan tunggal ke g.pesan dengan pemisahan teks dalam skrip menggunakan garis miring terbalik sebagai yang terakhir
karakter. (Dalam skrip Shell jangan tutup "kutipan")

Baris kosong dapat diperoleh dengan
g.pesan pesan=""

Spasi putih yang berlebihan akan dihilangkan.

Disarankan untuk mengutip pesan tunggal yang akan dicetak secara harfiah. Ini mencegah
sejumlah karakter (terutama, spasi dan tanda dolar '$') agar tidak diperlakukan
khusus oleh cangkangnya.

Bila perlu menyertakan, misalnya, nilai variabel sebagai bagian dari pesan,
tanda kutip ganda dapat digunakan, yang tidak menghilangkan tanda dolar dari spesialnya
kekuatan variabel-ekspansi.

Meskipun diketahui bahwa instance Bash interaktif dapat menggunakan tanda seru '!'
karakter secara khusus (membuat kutipan tunggal diperlukan), seharusnya tidak demikian
untuk instance Bash yang non-interaktif. Meskipun demikian, untuk menghindari kebingungan berbasis konteks
nanti Anda didorong untuk pesan kutipan tunggal yang tidak memerlukan $VARIABEL
ekspansi.

penggunaan in Ular sanca script
GRASS Python Scripting Library mendefinisikan pembungkus khusus untuk g.pesan.

· debug() untuk g.message -d

· error() untuk g.message -e

· fatal() untuk g.message -e + exit()

· info() untuk g.message -i

· pesan() untuk g.pesan

· verbose() untuk g.message -v

· peringatan() untuk g.message -w

Catatan: Shell Python di wxGUI dapat digunakan untuk memasukkan kode contoh berikut:

impor grass.script sebagai gcore
gcore.warning("Ini adalah peringatan")
identik dengan
g.message -w message="Ini adalah peringatan"

VERBOSITAS TINGKAT
Dikendalikan oleh variabel lingkungan "GRASS_VERBOSE". Biasanya ini diatur menggunakan
--diam or --bertele-tele opsi baris perintah.

· 0 - hanya kesalahan dan peringatan yang dicetak

· 1 - pesan kemajuan dicetak

· 2 - semua pesan modul dicetak

· 3 - pesan verbose tambahan dicetak

DEBUG TINGKAT
Dikendalikan oleh RUMPUT "DEBUG" gisenv variabel (diatur dengan g.gisenv).
Tingkat yang direkomendasikan:

· 1 - pesan dicetak sekali atau beberapa kali per modul

· 3 - setiap baris (raster) atau baris (vektor)

· 5 - setiap sel (raster) atau titik (vektor)

Gunakan g.messagegrass online menggunakan layanan onworks.net