Global functions

Table of Contents

1. New global functions in Rebol 1.2.10.3.1 (from 1.2.1.3.1)
      1.1. as-pair
      1.2. attempt
      1.3. brightness?
      1.4. build-attach-body
      1.5. build-markup
      1.6. component?
      1.7. construct
      1.8. create-link
      1.9. create-reg
      1.10. decloak
      1.11. delete-reg
      1.12. dump-obj
      1.13. eighth
      1.14. encloak
      1.15. exists-reg?
      1.16. free-boot
      1.17. get-env
      1.18. get-reg
      1.19. license
      1.20. link-relative-path
      1.21. list-reg
      1.22. local-request-file
      1.23. native
      1.24. ninth
      1.25. notify
      1.26. remove-each
      1.27. run
      1.28. scroll-drag
      1.29. set-browser-path
      1.30. set-reg
      1.31. seventh
      1.32. sign?
      1.33. sixth
      1.34. stats
      1.35. suffix?
      1.36. tenth
      1.37. to-action
      1.38. to-any-block
      1.39. to-any-function
      1.40. to-any-string
      1.41. to-any-type
      1.42. to-any-word
      1.43. to-context
      1.44. to-datatype
      1.45. to-end
      1.46. to-error
      1.47. to-function
      1.48. to-library
      1.49. to-native
      1.50. to-number
      1.51. to-object
      1.52. to-op
      1.53. to-port
      1.54. to-routine
      1.55. to-series
      1.56. to-struct
      1.57. to-symbol
      1.58. to-unset
      1.59. unset-reg-funcs
2. Lost global functions in Rebol 1.2.10.3.1 (from 1.2.1.3.1)
      2.1. boot-prefs
      2.2. demo
      2.3. exists-key?
      2.4. get-net-info
      2.5. load-prefs
      2.6. reboot
      2.7. save-prefs
      2.8. set-user
      2.9. uninstall
      2.10. view-install
      2.11. view-prefs
      2.12. view?

1. New global functions in Rebol 1.2.10.3.1 (from 1.2.1.3.1)

1.1. as-pair

USAGE:

AS-PAIR x y

DESCRIPTION:

Combine X and Y values into a pair. 
AS-PAIR is a function value.

ARGUMENTS:

x -- (Type: number)
y -- (Type: number)

1.2. attempt

USAGE:

ATTEMPT value

DESCRIPTION:

Tries to evaluate and returns result or NONE on error. 
ATTEMPT is a function value.

ARGUMENTS:

value -- (Type: any)

1.3. brightness?

USAGE:

BRIGHTNESS? color

DESCRIPTION:

Returns the monochrome brightness (0.0 to 1.0) for a color value. 
BRIGHTNESS? is a function value.

ARGUMENTS:

color -- (Type: tuple)

1.4. build-attach-body

USAGE:

BUILD-ATTACH-BODY body files boundary

DESCRIPTION:

Return an email body with attached files. 
BUILD-ATTACH-BODY is a function value.

ARGUMENTS:

body -- The message body (Type: string)
files -- List of files to send [%file1.r [%file2.r "data"]] (Type: block)
boundary -- The boundary divider (Type: string)

1.5. build-markup

USAGE:

BUILD-MARKUP content /quiet

DESCRIPTION:

Return markup text replacing <%tags%> with their evaluated results. 
BUILD-MARKUP is a function value.

ARGUMENTS:

content -- (Type: string file url)

REFINEMENTS:

/quiet -- Do not show errors in the output.

1.6. component?

USAGE:

COMPONENT? name

DESCRIPTION:

Returns specific REBOL component info if enabled. 
COMPONENT? is a function value.

ARGUMENTS:

name -- (Type: word)

1.7. construct

USAGE:

CONSTRUCT block /with object

DESCRIPTION:

Creates an object, but without evaluating its specification. 
CONSTRUCT is a native value.

ARGUMENTS:

block -- Object specification block (Type: block)

REFINEMENTS:

/with -- Provide a default base object
    object -- (Type: object)

1.8. create-link

USAGE:

CREATE-LINK source dest /start dir /note desc /args arg-str

DESCRIPTION:

Creates file links. 
CREATE-LINK is a native value.

ARGUMENTS:

source -- File to link to (Type: string file)
dest -- Name for new link (Type: string file)

REFINEMENTS:

/start
    dir -- Directory to start in (Windows) (Type: string file)
/note
    desc -- Link description text (Windows) (Type: string)
/args
    arg-str -- Provide command arguments (Type: string none)

1.9. create-reg

USAGE:

CREATE-REG key-path /hkcr /hkcu /hklm /hku /hkcc /hkdd

DESCRIPTION:

Creates a registry key and returns TRUE on success. (HKCU is default) 
CREATE-REG is a native value.

ARGUMENTS:

key-path -- (Type: string)

REFINEMENTS:

/hkcr
/hkcu
/hklm
/hku
/hkcc
/hkdd

1.10. decloak

USAGE:

DECLOAK data key /with

DESCRIPTION:

Descrambles the string scrambled by encloak. 
DECLOAK is a native value.

ARGUMENTS:

data -- String to descramble (modified) (Type: any-string)
key -- Key to use (Type: any-string)

REFINEMENTS:

/with -- Use key as-is (for speed, no hashing)

1.11. delete-reg

USAGE:

DELETE-REG key-path /hkcr /hkcu /hklm /hku /hkcc /hkdd

DESCRIPTION:

Deletes a registry key. Returns TRUE if deleted. (HKCU is default) 
DELETE-REG is a native value.

ARGUMENTS:

key-path -- (Type: string)

REFINEMENTS:

/hkcr
/hkcu
/hklm
/hku
/hkcc
/hkdd

1.12. dump-obj

USAGE:

DUMP-OBJ obj /match pat

DESCRIPTION:

Returns a block of information about an object. 
DUMP-OBJ is a function value.

ARGUMENTS:

obj -- (Type: object)

REFINEMENTS:

/match -- Include only those that match a string or datatype
    pat -- (Type: any)

1.13. eighth

USAGE:

EIGHTH series

DESCRIPTION:

Returns the eight value of a series. 
EIGHTH is an action value.

ARGUMENTS:

series -- (Type: series port tuple)

1.14. encloak

USAGE:

ENCLOAK data key /with

DESCRIPTION:

Scrambles a string or binary based on a key. 
ENCLOAK is a native value.

ARGUMENTS:

data -- String to scramble (modified) (Type: any-string)
key -- Key to use (Type: any-string)

REFINEMENTS:

/with -- Use key as-is (for speed, no hashing)

1.15. exists-reg?

USAGE:

EXISTS-REG? key-path /hkcr /hkcu /hklm /hku /hkcc /hkdd

DESCRIPTION:

Returns TRUE if registry key exists. (HKCU is default) 
EXISTS-REG? is a native value.

ARGUMENTS:

key-path -- (Type: string)

REFINEMENTS:

/hkcr
/hkcu
/hklm
/hku
/hkcc
/hkdd

1.16. free-boot

USAGE:

FREE-BOOT

DESCRIPTION:

Called by any code that takes over bootstrap. 
FREE-BOOT is a function value.

1.17. get-env

USAGE:

GET-ENV var

DESCRIPTION:

Gets the value of an operating system environment variable. 
GET-ENV is a native value.

ARGUMENTS:

var -- Variable to lookup (Type: string)

1.18. get-reg

USAGE:

GET-REG key-path id /hkcr /hkcu /hklm /hku /hkcc /hkdd

DESCRIPTION:

Returns value of a registry key, else NONE. (HKCU is default) 
GET-REG is a native value.

ARGUMENTS:

key-path -- (Type: string)
id -- (Type: string)

REFINEMENTS:

/hkcr
/hkcu
/hklm
/hku
/hkcc
/hkdd

1.19. license

USAGE:

LICENSE

DESCRIPTION:

Prints the REBOL/core license agreement. 
LICENSE is a function value.

1.20. link-relative-path

USAGE:

LINK-RELATIVE-PATH file

DESCRIPTION:

Remove link-root from a file path 
LINK-RELATIVE-PATH is a function value.

ARGUMENTS:

file -- (Type: any)

1.21. list-reg

USAGE:

LIST-REG key-path /hkcr /hkcu /hklm /hku /hkcc /hkdd

DESCRIPTION:

Returns a block of sub-keys for a registry key. (HKCU is default) 
LIST-REG is a native value.

ARGUMENTS:

key-path -- (Type: string)

REFINEMENTS:

/hkcr
/hkcu
/hklm
/hku
/hkcc
/hkdd

1.22. local-request-file

USAGE:

LOCAL-REQUEST-FILE parms

DESCRIPTION:

Creates an OS-specific file requester 
LOCAL-REQUEST-FILE is a native value.

ARGUMENTS:

parms -- Parameter block (Type: block)

1.23. native

USAGE:
NATIVE spec
DESCRIPTION:
(undocumented)
ARGUMENTS:
spec -- (Type: block)

1.24. ninth

USAGE:

NINTH series

DESCRIPTION:

Returns the ninth value of a series. 
NINTH is an action value.

ARGUMENTS:

series -- (Type: series port tuple)

1.25. notify

USAGE:

NOTIFY str

DESCRIPTION:

Flashes an informational message to the user. Waits for a user response. 
NOTIFY is a function value.

ARGUMENTS:

str -- (Type: any)

1.26. remove-each

USAGE:

REMOVE-EACH 'word data body

DESCRIPTION:

Removes a value from a series for each block that returns TRUE. 
REMOVE-EACH is a native value.

ARGUMENTS:

word -- Word or block of words to set each time (will be local) (Type: get-word word block)
data -- The series to traverse (Type: series)
body -- Block to evaluate. Return TRUE to remove. (Type: block)

1.27. run

USAGE:

RUN file /as suffix

DESCRIPTION:

Runs the system application associated with a file. 
RUN is a native value.

ARGUMENTS:

file -- The file to open (file, URL) or command to run (string). (Type: file url string)

REFINEMENTS:

/as
    suffix -- (Type: string file)

1.28. scroll-drag

USAGE:

SCROLL-DRAG face /back /page

DESCRIPTION:

Move the scroller drag bar 
SCROLL-DRAG is a function value.

ARGUMENTS:

face -- the scroller to modify (Type: any)

REFINEMENTS:

/back -- move backward
/page -- move each time by one page

1.29. set-browser-path

USAGE:

SET-BROWSER-PATH value

DESCRIPTION:

Path to default web browser. 
SET-BROWSER-PATH is a native value.

ARGUMENTS:

value -- The shell call string (Type: any-string)

1.30. set-reg

USAGE:

SET-REG key-path id value /hkcr /hkcu /hklm /hku /hkcc /hkdd

DESCRIPTION:

Sets registry key value. Returns value on success, else NONE. (HKCU is default) 
SET-REG is a native value.

ARGUMENTS:

key-path -- (Type: string)
id -- (Type: string)
value -- (Type: any-string)

REFINEMENTS:

/hkcr
/hkcu
/hklm
/hku
/hkcc
/hkdd

1.31. seventh

USAGE:

SEVENTH series

DESCRIPTION:

Returns the seventh value of a series. 
SEVENTH is an action value.

ARGUMENTS:

series -- (Type: series port tuple event)

1.32. sign?

USAGE:

SIGN? number

DESCRIPTION:

Returns sign of number as 1, 0, or -1 (to use as multiplier). 
SIGN? is a function value.

ARGUMENTS:

number -- (Type: number money time)

1.33. sixth

USAGE:

SIXTH series

DESCRIPTION:

Returns the sixth value of a series. 
SIXTH is an action value.

ARGUMENTS:

series -- (Type: series port tuple event)

1.34. stats

USAGE:

STATS /pools /types /series /frames /recycle

DESCRIPTION:

System statistics.  Default is to return total memory used. 
STATS is a native value.

REFINEMENTS:

/pools -- Returns: width units free-units units-per-alloc segments mem-in-use
/types -- Returns: Datatype count
/series -- Returns: total blocks strings other avail free expansions
/frames -- Returns: total used unused free values-total
/recycle -- Returns: count series-total series-last frames-total frames-last ballast

1.35. suffix?

USAGE:

SUFFIX? path

DESCRIPTION:

Return the suffix (ext) of a filename or url, else NONE. 
SUFFIX? is a function value.

ARGUMENTS:

path -- (Type: any-string)

1.36. tenth

USAGE:

TENTH series

DESCRIPTION:

Returns the tenth value of a series. 
TENTH is an action value.

ARGUMENTS:

series -- (Type: series port tuple)

1.37. to-action

USAGE:
TO-ACTION value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.38. to-any-block

USAGE:
TO-ANY-BLOCK value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.39. to-any-function

USAGE:
TO-ANY-FUNCTION value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.40. to-any-string

USAGE:
TO-ANY-STRING value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.41. to-any-type

USAGE:
TO-ANY-TYPE value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.42. to-any-word

USAGE:
TO-ANY-WORD value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.43. to-context

USAGE:
TO-CONTEXT value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.44. to-datatype

USAGE:
TO-DATATYPE value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.45. to-end

USAGE:
TO-END value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.46. to-error

USAGE:
TO-ERROR value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.47. to-function

USAGE:
TO-FUNCTION value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.48. to-library

USAGE:
TO-LIBRARY value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.49. to-native

USAGE:
TO-NATIVE value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.50. to-number

USAGE:
TO-NUMBER value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.51. to-object

USAGE:
TO-OBJECT value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.52. to-op

USAGE:
TO-OP value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.53. to-port

USAGE:
TO-PORT value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.54. to-routine

USAGE:
TO-ROUTINE value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.55. to-series

USAGE:
TO-SERIES value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.56. to-struct

USAGE:
TO-STRUCT value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.57. to-symbol

USAGE:
TO-SYMBOL value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.58. to-unset

USAGE:
TO-UNSET value
DESCRIPTION:
(undocumented)
ARGUMENTS:
value -- (Type: any)

1.59. unset-reg-funcs

USAGE:
UNSET-REG-FUNCS
DESCRIPTION:
(undocumented)