Команды SFK


    1        2        3        4        5        6        7        8        9        10    

Раздел 7. Scripting - Скрипты
alias | batch | call | cd | clock | color | echo | for | getcwd | label | loop | mkcd | pause | require | setvar | sleep | stop | storetext | tee | time | tofile | toterm |

Help:   Рус   |   Eng        

Команда: label
sfk label name [options] +...
sfk ... +label name +...

   define a label at the beginning or within an sfk script.
   a label is a user-defined name that can be jumped to
   by the sfk script command.

   prefix option

      -prefix=s    set user-defined input parameter name prefix.

      by default, parameters passed into sfk scripts are called $1 to $9,
      or %1 to %9. with -prefix, you can define your own parameter names,
      e.g. if you rewrite the sfk label line like this:

         sfk label begin -prefix=$parm

      then the input parameters are renamed to $parm1, $parm2, ...
      accepting no other names. or simply say

         sfk label begin -prefix=%

      to accept ONLY %1 to %9 but NOT $1 to $9, to get around conflicts
      with script commands using expressions like "$10.10col1".

   global options

      these options after "label" are global and therefore
      valid for all following commands. Use them only
      at the first label in a script for clarity.

      -var         enable use of variables like #(name)

      -qtrim       automatic reformatting of quoted multi line
                   parameters depending on target command.
                   this is default since SFK 1.8.0.
                   e.g. +echo will keep line ends and some leading
                   spaces to apply auto indentation, while +xed
                   will strip all leading spaces and line ends.
                   see "sfk script" for details.

      -qraw        do not reformat quoted multi line parameters.
                   this was default with sfk up to 1.7.7.
                   since sfk 1.8.0 some old scripts may need:
                      sfk label labelname -qraw
                   or via environment variable:
                      set SFK_CONFIG=qraw

      -keepdata    use old sfk 1.9.2 data passing.
                   for details see: sfk help chain

      for further options see: sfk help opt

      options must be given after the label name.
      if -prefix is used it must be the first option.

   examples
      sfk samp sfkbat mytest.bat
         creates a windows batch file mytest.bat
         with an embedded sfk command script.

      sfk samp sfkbash mytest
         creates a linux batch file mytest
         with an embedded sfk command script.

   see also
      sfk script   how to run sfk scripts.
      sfk if       about conditional execution.
      sfk goto     jump to a local label.
      sfk setglobalopt   change global options.