Rebol Programming/find

From Wikibooks, open books for an open world
Jump to navigation Jump to search

USAGE:[edit | edit source]

FIND series value /part range /only /case /any /with wild /skip size /match /tail /last /reverse 

DESCRIPTION:[edit | edit source]

Finds a value in a series and returns the series at the start of it.

FIND is an action value.

ARGUMENTS[edit | edit source]

  • series -- (Type: series object port bitset)
  • value -- (Type: any-type)

REFINEMENTS[edit | edit source]

  • /part -- Limits the search to a given length or position.
    • range -- (Type: number series port)
  • /only -- Treats a series value as a single value.
  • /case -- Characters are case-sensitive.
  • /any -- Enables the * and ? wildcards.
  • /with -- Allows custom wildcards.
    • wild -- Specifies alternates for * and ? (Type: string)
  • /skip -- Treat the series as records of fixed size
    • size -- (Type: integer)
  • /match -- Performs comparison and returns the tail of the match.
  • /tail -- Returns the end of the string.
  • /last -- Backwards from end of string.
  • /reverse -- Backwards from the current position.

SOURCE CODE[edit | edit source]

find: native[
    {Finds a value in a series and returns the series at the start of it.} 
    series [series! object! port! bitset!] 
    value [any-type!] 
    /part "Limits the search to a given length or position." 
    range [number! series! port!] 
    /only "Treats a series value as a single value." 
    /case "Characters are case-sensitive." 
    /any "Enables the * and ? wildcards." 
    /with "Allows custom wildcards." 
    wild [string!] "Specifies alternates for * and ?" 
    /skip "Treat the series as records of fixed size" 
    size [integer!] 
    /match {Performs comparison and returns the tail of the match.} 
    /tail "Returns the end of the string." 
    /last "Backwards from end of string." 
    /reverse "Backwards from the current position."
]