Gecko [ edgpens.lpkmn.gov.my ]

Name	Size	Permission
arabic.txt	11.92 KB	-rw-rw-rw-
autocmd.txt	74.85 KB	-rw-rw-rw-
builtin.txt	399.47 KB	-rw-rw-rw-
change.txt	77.8 KB	-rw-rw-rw-
channel.txt	58.14 KB	-rw-rw-rw-
cmdline.txt	49.49 KB	-rw-rw-rw-
debug.txt	6.73 KB	-rw-rw-rw-
debugger.txt	5.32 KB	-rw-rw-rw-
develop.txt	22.33 KB	-rw-rw-rw-
diff.txt	17.42 KB	-rw-rw-rw-
digraph.txt	60.63 KB	-rw-rw-rw-
editing.txt	73.79 KB	-rw-rw-rw-
eval.txt	180.3 KB	-rw-rw-rw-
farsi.txt	523 B	-rw-rw-rw-
filetype.txt	27.79 KB	-rw-rw-rw-
fold.txt	23.69 KB	-rw-rw-rw-
ft_ada.txt	17.79 KB	-rw-rw-rw-
ft_ps1.txt	2.14 KB	-rw-rw-rw-
ft_raku.txt	4.12 KB	-rw-rw-rw-
ft_rust.txt	9.38 KB	-rw-rw-rw-
ft_sql.txt	29.98 KB	-rw-rw-rw-
gui.txt	52.02 KB	-rw-rw-rw-
gui_w32.txt	18.74 KB	-rw-rw-rw-
gui_x11.txt	28.5 KB	-rw-rw-rw-
hangulin.txt	598 B	-rw-rw-rw-
hebrew.txt	5.53 KB	-rw-rw-rw-
help.txt	9.03 KB	-rw-rw-rw-
helphelp.txt	15.56 KB	-rw-rw-rw-
howto.txt	2.85 KB	-rw-rw-rw-
if_cscop.txt	18.87 KB	-rw-rw-rw-
if_lua.txt	18.11 KB	-rw-rw-rw-
if_mzsch.txt	11.66 KB	-rw-rw-rw-
if_ole.txt	7.19 KB	-rw-rw-rw-
if_perl.txt	11.07 KB	-rw-rw-rw-
if_pyth.txt	38.52 KB	-rw-rw-rw-
if_ruby.txt	8.32 KB	-rw-rw-rw-
if_sniff.txt	271 B	-rw-rw-rw-
if_tcl.txt	22.41 KB	-rw-rw-rw-
indent.txt	41.25 KB	-rw-rw-rw-
index.txt	79.41 KB	-rw-rw-rw-
insert.txt	85.79 KB	-rw-rw-rw-
intro.txt	38.08 KB	-rw-rw-rw-
map.txt	75.29 KB	-rw-rw-rw-
mbyte.txt	57.27 KB	-rw-rw-rw-
message.txt	31.18 KB	-rw-rw-rw-
mlang.txt	8 KB	-rw-rw-rw-
motion.txt	50.85 KB	-rw-rw-rw-
netbeans.txt	37.07 KB	-rw-rw-rw-
options.txt	396.37 KB	-rw-rw-rw-
os_390.txt	4.64 KB	-rw-rw-rw-
os_amiga.txt	5.34 KB	-rw-rw-rw-
os_beos.txt	293 B	-rw-rw-rw-
os_dos.txt	15.13 KB	-rw-rw-rw-
os_haiku.txt	8.3 KB	-rw-rw-rw-
os_mac.txt	6.7 KB	-rw-rw-rw-
os_mint.txt	391 B	-rw-rw-rw-
os_msdos.txt	523 B	-rw-rw-rw-
os_os2.txt	299 B	-rw-rw-rw-
os_qnx.txt	3.98 KB	-rw-rw-rw-
os_risc.txt	328 B	-rw-rw-rw-
os_unix.txt	2.54 KB	-rw-rw-rw-
os_vms.txt	32.14 KB	-rw-rw-rw-
os_win32.txt	14.32 KB	-rw-rw-rw-
pattern.txt	61.74 KB	-rw-rw-rw-
pi_getscript.txt	20.59 KB	-rw-rw-rw-
pi_gzip.txt	1.26 KB	-rw-rw-rw-
pi_logipat.txt	4.1 KB	-rw-rw-rw-
pi_netrw.txt	177.69 KB	-rw-rw-rw-
pi_paren.txt	2.22 KB	-rw-rw-rw-
pi_spec.txt	4.03 KB	-rw-rw-rw-
pi_tar.txt	7.08 KB	-rw-rw-rw-
pi_vimball.txt	11.58 KB	-rw-rw-rw-
pi_zip.txt	7.32 KB	-rw-rw-rw-
popup.txt	39.24 KB	-rw-rw-rw-
print.txt	30.62 KB	-rw-rw-rw-
quickfix.txt	82.82 KB	-rw-rw-rw-
quickref.txt	70.92 KB	-rw-rw-rw-
quotes.txt	12.45 KB	-rw-rw-rw-
recover.txt	10.47 KB	-rw-rw-rw-
remote.txt	8.43 KB	-rw-rw-rw-
repeat.txt	44.48 KB	-rw-rw-rw-
rileft.txt	4.71 KB	-rw-rw-rw-
russian.txt	2.95 KB	-rw-rw-rw-
scroll.txt	13.55 KB	-rw-rw-rw-
sign.txt	26.24 KB	-rw-rw-rw-
spell.txt	62.59 KB	-rw-rw-rw-
sponsor.txt	6.64 KB	-rw-rw-rw-
starting.txt	72.73 KB	-rw-rw-rw-
syntax.txt	227.07 KB	-rw-rw-rw-
tabpage.txt	16.92 KB	-rw-rw-rw-
tags	363.14 KB	-rw-rw-rw-
tagsrch.txt	39.36 KB	-rw-rw-rw-
term.txt	48.72 KB	-rw-rw-rw-
terminal.txt	57.42 KB	-rw-rw-rw-
testing.txt	18.59 KB	-rw-rw-rw-
textprop.txt	16.01 KB	-rw-rw-rw-
tips.txt	20.6 KB	-rw-rw-rw-
todo.txt	300.01 KB	-rw-rw-rw-
uganda.txt	12.73 KB	-rw-rw-rw-
undo.txt	16.32 KB	-rw-rw-rw-
usr_01.txt	6.92 KB	-rw-rw-rw-
usr_02.txt	23.66 KB	-rw-rw-rw-
usr_03.txt	23.31 KB	-rw-rw-rw-
usr_04.txt	18.68 KB	-rw-rw-rw-
usr_05.txt	26.39 KB	-rw-rw-rw-
usr_06.txt	10.39 KB	-rw-rw-rw-
usr_07.txt	15.62 KB	-rw-rw-rw-
usr_08.txt	18.92 KB	-rw-rw-rw-
usr_09.txt	11.23 KB	-rw-rw-rw-
usr_10.txt	28.52 KB	-rw-rw-rw-
usr_11.txt	12.72 KB	-rw-rw-rw-
usr_12.txt	13.12 KB	-rw-rw-rw-
usr_20.txt	13.41 KB	-rw-rw-rw-
usr_21.txt	18.02 KB	-rw-rw-rw-
usr_22.txt	14.65 KB	-rw-rw-rw-
usr_23.txt	12.45 KB	-rw-rw-rw-
usr_24.txt	20.34 KB	-rw-rw-rw-
usr_25.txt	18.73 KB	-rw-rw-rw-
usr_26.txt	8.07 KB	-rw-rw-rw-
usr_27.txt	17.29 KB	-rw-rw-rw-
usr_28.txt	15.64 KB	-rw-rw-rw-
usr_29.txt	19.78 KB	-rw-rw-rw-
usr_30.txt	22.13 KB	-rw-rw-rw-
usr_31.txt	10.16 KB	-rw-rw-rw-
usr_32.txt	5.25 KB	-rw-rw-rw-
usr_40.txt	22.65 KB	-rw-rw-rw-
usr_41.txt	62.4 KB	-rw-rw-rw-
usr_42.txt	13.53 KB	-rw-rw-rw-
usr_43.txt	7.24 KB	-rw-rw-rw-
usr_44.txt	28.27 KB	-rw-rw-rw-
usr_45.txt	17.27 KB	-rw-rw-rw-
usr_50.txt	4.88 KB	-rw-rw-rw-
usr_51.txt	24.9 KB	-rw-rw-rw-
usr_52.txt	13.13 KB	-rw-rw-rw-
usr_90.txt	16.44 KB	-rw-rw-rw-
usr_toc.txt	9.67 KB	-rw-rw-rw-
various.txt	30.93 KB	-rw-rw-rw-
version4.txt	13.58 KB	-rw-rw-rw-
version5.txt	301.31 KB	-rw-rw-rw-
version6.txt	563.42 KB	-rw-rw-rw-
version7.txt	658.89 KB	-rw-rw-rw-
version8.txt	1.53 MB	-rw-rw-rw-
version9.txt	1.03 MB	-rw-rw-rw-
vi_diff.txt	56.06 KB	-rw-rw-rw-
vim2html.pl	4.41 KB	-rw-rw-rw-
vim9.txt	80.52 KB	-rw-rw-rw-
visual.txt	21.59 KB	-rw-rw-rw-
windows.txt	54.79 KB	-rw-rw-rw-
workshop.txt	371 B	-rw-rw-rw-

Name

Size

Permission

Action

arabic.txt

11.92 KB

-rw-rw-rw-

autocmd.txt

74.85 KB

-rw-rw-rw-

builtin.txt

399.47 KB

-rw-rw-rw-

change.txt

77.8 KB

-rw-rw-rw-

channel.txt

58.14 KB

-rw-rw-rw-

cmdline.txt

49.49 KB

-rw-rw-rw-

debug.txt

6.73 KB

-rw-rw-rw-

debugger.txt

5.32 KB

-rw-rw-rw-

develop.txt

22.33 KB

-rw-rw-rw-

diff.txt

17.42 KB

-rw-rw-rw-

digraph.txt

60.63 KB

-rw-rw-rw-

editing.txt

73.79 KB

-rw-rw-rw-

eval.txt

180.3 KB

-rw-rw-rw-

farsi.txt

523 B

-rw-rw-rw-

filetype.txt

27.79 KB

-rw-rw-rw-

fold.txt

23.69 KB

-rw-rw-rw-

ft_ada.txt

17.79 KB

-rw-rw-rw-

ft_ps1.txt

2.14 KB

-rw-rw-rw-

ft_raku.txt

4.12 KB

-rw-rw-rw-

ft_rust.txt

9.38 KB

-rw-rw-rw-

ft_sql.txt

29.98 KB

-rw-rw-rw-

gui.txt

52.02 KB

-rw-rw-rw-

gui_w32.txt

18.74 KB

-rw-rw-rw-

gui_x11.txt

28.5 KB

-rw-rw-rw-

hangulin.txt

598 B

-rw-rw-rw-

hebrew.txt

5.53 KB

-rw-rw-rw-

help.txt

9.03 KB

-rw-rw-rw-

helphelp.txt

15.56 KB

-rw-rw-rw-

howto.txt

2.85 KB

-rw-rw-rw-

if_cscop.txt

18.87 KB

-rw-rw-rw-

if_lua.txt

18.11 KB

-rw-rw-rw-

if_mzsch.txt

11.66 KB

-rw-rw-rw-

if_ole.txt

7.19 KB

-rw-rw-rw-

if_perl.txt

11.07 KB

-rw-rw-rw-

if_pyth.txt

38.52 KB

-rw-rw-rw-

if_ruby.txt

8.32 KB

-rw-rw-rw-

if_sniff.txt

271 B

-rw-rw-rw-

if_tcl.txt

22.41 KB

-rw-rw-rw-

indent.txt

41.25 KB

-rw-rw-rw-

index.txt

79.41 KB

-rw-rw-rw-

insert.txt

85.79 KB

-rw-rw-rw-

intro.txt

38.08 KB

-rw-rw-rw-

map.txt

75.29 KB

-rw-rw-rw-

mbyte.txt

57.27 KB

-rw-rw-rw-

message.txt

31.18 KB

-rw-rw-rw-

mlang.txt

8 KB

-rw-rw-rw-

motion.txt

50.85 KB

-rw-rw-rw-

netbeans.txt

37.07 KB

-rw-rw-rw-

options.txt

396.37 KB

-rw-rw-rw-

os_390.txt

4.64 KB

-rw-rw-rw-

os_amiga.txt

5.34 KB

-rw-rw-rw-

os_beos.txt

293 B

-rw-rw-rw-

os_dos.txt

15.13 KB

-rw-rw-rw-

os_haiku.txt

8.3 KB

-rw-rw-rw-

os_mac.txt

6.7 KB

-rw-rw-rw-

os_mint.txt

391 B

-rw-rw-rw-

os_msdos.txt

523 B

-rw-rw-rw-

os_os2.txt

299 B

-rw-rw-rw-

os_qnx.txt

3.98 KB

-rw-rw-rw-

os_risc.txt

328 B

-rw-rw-rw-

os_unix.txt

2.54 KB

-rw-rw-rw-

os_vms.txt

32.14 KB

-rw-rw-rw-

os_win32.txt

14.32 KB

-rw-rw-rw-

pattern.txt

61.74 KB

-rw-rw-rw-

pi_getscript.txt

20.59 KB

-rw-rw-rw-

pi_gzip.txt

1.26 KB

-rw-rw-rw-

pi_logipat.txt

4.1 KB

-rw-rw-rw-

pi_netrw.txt

177.69 KB

-rw-rw-rw-

pi_paren.txt

2.22 KB

-rw-rw-rw-

pi_spec.txt

4.03 KB

-rw-rw-rw-

pi_tar.txt

7.08 KB

-rw-rw-rw-

pi_vimball.txt

11.58 KB

-rw-rw-rw-

pi_zip.txt

7.32 KB

-rw-rw-rw-

popup.txt

39.24 KB

-rw-rw-rw-

print.txt

30.62 KB

-rw-rw-rw-

quickfix.txt

82.82 KB

-rw-rw-rw-

quickref.txt

70.92 KB

-rw-rw-rw-

quotes.txt

12.45 KB

-rw-rw-rw-

recover.txt

10.47 KB

-rw-rw-rw-

remote.txt

8.43 KB

-rw-rw-rw-

repeat.txt

44.48 KB

-rw-rw-rw-

rileft.txt

4.71 KB

-rw-rw-rw-

russian.txt

2.95 KB

-rw-rw-rw-

scroll.txt

13.55 KB

-rw-rw-rw-

sign.txt

26.24 KB

-rw-rw-rw-

spell.txt

62.59 KB

-rw-rw-rw-

sponsor.txt

6.64 KB

-rw-rw-rw-

starting.txt

72.73 KB

-rw-rw-rw-

syntax.txt

227.07 KB

-rw-rw-rw-

tabpage.txt

16.92 KB

-rw-rw-rw-

Code Editor : usr_50.txt

*usr_50.txt*	For Vim version 8.2.  Last change: 2022 Jun 03

VIM USER MANUAL - by Bram Moolenaar

Advanced Vim script writing

|50.1|	Exceptions
|50.2|    Function with variable number of arguments
|50.3|	Restoring the view

==============================================================================
*50.1*	Exceptions

Let's start with an example: >

try
	   read ~/templates/pascal.tmpl
	catch /E484:/
	   echo "Sorry, the Pascal template file cannot be found."
	endtry

The `read` command will fail if the file does not exist.  Instead of
generating an error message, this code catches the error and gives the user a
message with more information.

For the commands in between `try` and `endtry` errors are turned into
exceptions.  An exception is a string.  In the case of an error the string
contains the error message.  And every error message has a number.  In this
case, the error we catch contains "E484:".  This number is guaranteed to stay
the same (the text may change, e.g., it may be translated).

Besides being able to give a nice error message, Vim will also continue
executing commands after the `:endtry`.  Otherwise, once an uncaught error is
encountered, execution of the script/function/mapping will be aborted.

When the `read` command causes another error, the pattern "E484:" will not
match in it.  Thus this exception will not be caught and result in the usual
error message and execution is aborted.

You might be tempted to do this: >

try
	   read ~/templates/pascal.tmpl
	catch
	   echo "Sorry, the Pascal template file cannot be found."
	endtry

This means all errors are caught.  But then you will not see an error that
would indicate a completely different problem, such as "E21: Cannot make
changes, 'modifiable' is off".  Think twice before you catch any error!

Another useful mechanism is the `finally` command: >

var tmp = tempname()
	try
	   exe ":.,$write " .. tmp
	   exe "!filter " .. tmp
	   :.,$delete
	   exe ":$read " .. tmp
	finally
	   delete(tmp)
	endtry

This filters the lines from the cursor until the end of the file through the
"filter" command, which takes a file name argument.  No matter if the
filtering works, if something goes wrong in between `try` and `finally` or the
user cancels the filtering by pressing CTRL-C, the `delete(tmp)` call is
always executed.  This makes sure you don't leave the temporary file behind.

The `finally` does not catch the exception, the error will still abort
further execution.

More information about exception handling can be found in the reference
manual: |exception-handling|.

==============================================================================
*50.2*	Function with variable number of arguments

Vim enables you to define functions that have a variable number of arguments.
The following command, for instance, defines a function that must have 1
argument (start) and can have up to 20 additional arguments: >

def Show(start: string, ...items: list<string>)

The variable "items" will be a list in the function containing the extra
arguments.  You can use it like any list, for example: >

def Show(start: string, ...items: list<string>)
	  echohl Title
	  echo "start is " .. start
	  echohl None
	  for index in range(len(items))
	    echon $"  Arg {index} is {items[index]}"
	  endfor
	  echo
	enddef

You can call it like this: >

Show('Title', 'one', 'two', 'three')
<	start is Title  Arg 0 is one  Arg 1 is two  Arg 2 is three ~
	
This uses the `echohl` command to specify the highlighting used for the
following `echo` command.  `echohl None` stops it again.  The `echon` command
works like `echo`, but doesn't output a line break.

If you call it with one argument the "items" list will be empty.
`range(len(items))` returns a list with the indexes, what `for` loops over,
we'll explain that further down.

==============================================================================
*50.3*	Restoring the view

Sometimes you want to make a change and go back to where the cursor was.
Restoring the relative position would also be nice, so that the same line
appears at the top of the window.

This example yanks the current line, puts it above the first line in the file
and then restores the view: >

map ,p ma"aYHmbgg"aP`bzt`a

What this does: >
	ma"aYHmbgg"aP`bzt`a
<	ma			set mark a at cursor position
	  "aY			yank current line into register a
	     Hmb		go to top line in window and set mark b there
		gg		go to first line in file
		  "aP		put the yanked line above it
		     `b		go back to top line in display
		       zt	position the text in the window as before
			 `a	go back to saved cursor position

==============================================================================

Next chapter: |usr_51.txt|  Create a plugin

${this.title}

Code Editor : usr_50.txt