extra/successor/successor-docs.factor

   1 ! Copyright (C) 2011 John Benediktsson.
   2 ! See http://factorcode.org/license.txt for BSD license.
   3
   4 USING: help.markup help.syntax successor strings ;
   5
   6 IN: successor
   7
   8 HELP: successor
   9 { $values { "str" string } { "str'" string } }
  10 { $description
  11     "Returns the successor to " { $snippet "str" } ". The successor is calculated by incrementing characters starting from the rightmost alphanumeric (or the rightmost character if there are no alphanumerics) in the string. Incrementing a digit always results in another digit, and incrementing a letter results in another letter of the same case."
  12     $nl
  13     "If the increment generates a carry, the character to the left of it is incremented. This process repeats until there is no carry, adding an additional character if necessary."
  14 } ;
  15
  16