home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT214.ZIP / SEBFU40.LZH / INSTR.DOC < prev    next >
Text File  |  1991-09-14  |  3KB  |  115 lines
  1.  
  2.                             I N S T R     Ver. 4.0
  3.  
  4.  
  5.                     (C)1989,1990,1991  Scanlon Enterprises
  6.  
  7.  
  8.  
  9.  
  10.  
  11.        INSTR is a small utility to get the position of a specified 
  12.        character in any DOS environment variable.
  13.  
  14.        This utility can be used in conjunction with the MID.COM utility 
  15.        to retrieve portions of a string, or simply to check if a string 
  16.        contains a specified character.
  17.  
  18.  
  19.        Syntax : INSTR var /Cc /Dn /Bn
  20.  
  21.  
  22.        **NOTE** 'var', and either '/Cc' or 'Dn' must be speified
  23.  
  24.  
  25.        Where : 'var' is the variable to search for a specified character
  26.                '/Cc' sets INSTR to search for character 'c'
  27.                '/Dn' sets INSTR to search for character of decimal value
  28.                      'n' IE... if 'n'=65 then character is an A
  29.                '/Bn' Start search in 'var' at character position 'n'
  30.  
  31.        Defaults: '/Bn' 'n' defaults to 1
  32.  
  33.  
  34.        ERRORLEVELS: 255 (0FF) = Program Problem (call Author)
  35.                     130       = Invalid option / param NOT specified
  36.                     129       = 'n' of option '/Bn' out of range
  37.                     128       = 'var' NOT found
  38.                    1-127      = position of search char in 'var'
  39.  
  40.  
  41.        EXAMPLES:
  42.  
  43.                INSTR PATH /C:
  44.  
  45.        Finds the first occurance of the ':' in the PATH variable.
  46.  
  47.                INSTR PATH /D65
  48.  
  49.        Finds the first occurance of A in the PATH variable (65=A)
  50.  
  51.                INSTR PATH /C: /B10
  52.  
  53.        Finds the first occurance of ':' in the PATH variable starting 
  54.        after the 10th character in the string.
  55.  
  56.  
  57.        For additional usage and information on using these utilities see 
  58.        the file SEBFU.DOC or BATUT.DOC.
  59.  
  60.  
  61.  
  62.  
  63.       Page 1 of 2
  64.  
  65.                              I N S T R    Ver. 4.0
  66.  
  67.  
  68.                     (C)1989,1990,1991  Scanlon Enterprises
  69.  
  70.  
  71.  
  72.                              O R D E R     F O R M
  73.  
  74.  
  75.  
  76.  
  77.        INSTR registration ..................................... $2.00
  78.  
  79.  
  80.  
  81.  
  82.        What you get :
  83.  
  84.        Unlimited usage of INSTR, and phone or write in support. You 
  85.        will also be placed on our mailing list for future updates and 
  86.        new products.
  87.  
  88.        We will ship an enhanced version of this utility if shipping and 
  89.        and material charge is included (see ORDER.DOC). Enhanced version 
  90.        includes these features:
  91.  
  92.                Environment variable can be set to contain the positon
  93.                A string of characters can be searched for
  94.                Option to set yes/no errorlevel instead of position
  95.                and more.....
  96.  
  97.        We are offering this utility seperate from SEBFU as a favor to 
  98.        users who do NOT wish to use many of the SEBFU utilities.
  99.  
  100.        This utility is automatically registered to you when you register 
  101.        SEBFU as a product (see REG.DOC). Registering SEBFU as a product 
  102.        is a better bargin, as each utility will cost less than $ .25 
  103.        each.
  104.  
  105.  
  106.        Vendors:
  107.  
  108.        You may distribute INSTR seperately, provided this document is 
  109.        distributed as well. Any reasonable fee may be charged.
  110.  
  111.  
  112.        Send your order to : SCANLON ENTERPRISES
  113.                             38354 17TH ST E.
  114.                             PALMDALE, CA 93550
  115.