context: /*
   * Copyright (c) Contributors, http://opensimulator.org/
   * See CONTRIBUTORS.TXT for a full list of copyright holders.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions are met:
   *     * Redistributions of source code must retain the above copyright
   *       notice, this list of conditions and the following disclaimer.
   *     * Redistributions in binary form must reproduce the above copyright
   *       notice, this list of conditions and the following disclaimer in the
   *       documentation and/or other materials provided with the distribution.
   *     * Neither the name of the OpenSimulator Project nor the
   *       names of its contributors may be used to endorse or promote products
   *       derived from this software without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
   * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
   * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
   * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
   * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
   * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
   * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   */
  
  using System;
  using System.Collections.Generic;
  using System.IO;
  using System.Linq;
  using System.Reflection;
  using log4net;
  using OpenMetaverse;
  
  namespace OpenSim.Framework.Console
  {
      public class ConsoleUtil
      {
      //    private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
  
          public const int LocalIdNotFound = 0;
      
          /// <summary>
          /// Used by modules to display stock co-ordinate help, though possibly this should be under some general section
          /// rather than in each help summary.
          /// </summary>
          public const string CoordHelp
      = @"Each component of the coord is comma separated.  There must be no spaces between the commas.
      If you don't care about the z component you can simply omit it.
      If you don't care about the x or y components then you can leave them blank (though a comma is still required)
      If you want to specify the maxmimum value of a component then you can use ~ instead of a number
      If you want to specify the minimum value of a component then you can use -~ instead of a number
      e.g.
      delete object pos 20,20,20 to 40,40,40
      delete object pos 20,20 to 40,40
      delete object pos ,20,20 to ,40,40
      delete object pos ,,30 to ,,~
      delete object pos ,,-~ to ,,30";
      
          public const string MinRawConsoleVectorValue = "-~";
          public const string MaxRawConsoleVectorValue = "~";
      
          public const string VectorSeparator = ",";
          public static char[] VectorSeparatorChars = VectorSeparator.ToCharArray();
  
          /// <summary>
          /// Check if the given file path exists.
          /// </summary>
          /// <remarks>If not, warning is printed to the given console.</remarks>
          /// <returns>true if the file does not exist, false otherwise.</returns>
          /// <param name='console'></param>
          /// <param name='path'></param>
          public static bool CheckFileDoesNotExist(ICommandConsole console, string path)
          {
              if (File.Exists(path))
              {
                  console.OutputFormat("File {0} already exists.  Please move or remove it.", path);
                  return false;
              }
  
              return true;
          }
      
          /// <summary>
          /// Try to parse a console UUID from the console.
          /// </summary>
          /// <remarks>
          /// Will complain to the console if parsing fails.
          /// </remarks>
          /// <returns></returns>
          /// <param name='console'>If null then no complaint is printed.</param>
          /// <param name='rawUuid'></param>
          /// <param name='uuid'></param>
          public static bool TryParseConsoleUuid(ICommandConsole console, string rawUuid, out UUID uuid)
          {
              if (!UUID.TryParse(rawUuid, out uuid))
              {
                  if (console != null)
                      console.OutputFormat("ERROR: {0} is not a valid uuid", rawUuid);
  
                  return false;
              }
      
              return true;
          }
  
          public static bool TryParseConsoleLocalId(ICommandConsole console, string rawLocalId, out uint localId)
          {
              if (!uint.TryParse(rawLocalId, out localId))
              {
                  if (console != null)
                      console.OutputFormat("ERROR: {0} is not a valid local id", localId);
  
                  return false;
              }
  
              if (localId == 0)
              {
                  if (console != null)
                      console.OutputFormat("ERROR: {0} is not a valid local id - it must be greater than 0", localId);
  
                  return false;
              }
  
              return true;
          }
  
          /// <summary>
          /// Tries to parse the input as either a UUID or a local ID.
          /// </summary>
          /// <returns>true if parsing succeeded, false otherwise.</returns>
          /// <param name='console'></param>
          /// <param name='rawId'></param>
          /// <param name='uuid'></param>
          /// <param name='localId'>
          /// Will be set to ConsoleUtil.LocalIdNotFound if parsing result was a UUID or no parse succeeded.
          /// </param>
          public static bool TryParseConsoleId(ICommandConsole console, string rawId, out UUID uuid, out uint localId)
          {
              if (TryParseConsoleUuid(null, rawId, out uuid))
              {
                  localId = LocalIdNotFound;
                  return true;
              }
  
              if (TryParseConsoleLocalId(null, rawId, out localId))
              {
                  return true;
              }
  
              if (console != null)
                  console.OutputFormat("ERROR: {0} is not a valid UUID or local id", rawId);
  
              return false;
          }
  
          /// <summary>
          /// Convert a minimum vector input from the console to an OpenMetaverse.Vector3
          /// </summary>
          /// <param name='console'>Can be null if no console is available.</param>
          /// <param name='rawConsoleVector'>/param>
          /// <param name='vector'></param>
          /// <returns></returns>
          public static bool TryParseConsoleInt(ICommandConsole console, string rawConsoleInt, out int i)
          {
              if (!int.TryParse(rawConsoleInt, out i))
              {
                  if (console != null)
                      console.OutputFormat("ERROR: {0} is not a valid integer", rawConsoleInt);
  
                  return false;
              }
  
              return true;
          }
      
          /// <summary>
          /// Convert a minimum vector input from the console to an OpenMetaverse.Vector3
          /// </summary>
          /// <param name='rawConsoleVector'>/param>
          /// <param name='vector'></param>
          /// <returns></returns>
          public static bool TryParseConsoleMinVector(string rawConsoleVector, out Vector3 vector)
          {
              return TryParseConsoleVector(rawConsoleVector, c => float.MinValue.ToString(), out vector);
          }
      
          /// <summary>
          /// Convert a maximum vector input from the console to an OpenMetaverse.Vector3
          /// </summary>
          /// <param name='rawConsoleVector'>/param>
          /// <param name='vector'></param>
          /// <returns></returns>
          public static bool TryParseConsoleMaxVector(string rawConsoleVector, out Vector3 vector)
          {
              return TryParseConsoleVector(rawConsoleVector, c => float.MaxValue.ToString(), out vector);
          }
      
          /// <summary>
          /// Convert a vector input from the console to an OpenMetaverse.Vector3
          /// </summary>
          /// <param name='rawConsoleVector'>
          /// A string in the form <x>,<y>,<z> where there is no space between values.
          /// Any component can be missing (e.g. ,,40).  blankComponentFunc is invoked to replace the blank with a suitable value
          /// Also, if the blank component is at the end, then the comma can be missed off entirely (e.g. 40,30 or 40)
          /// The strings "~" and "-~" are valid in components.  The first substitutes float.MaxValue whilst the second is float.MinValue
          /// Other than that, component values must be numeric.
          /// </param>
          /// <param name='blankComponentFunc'></param>
          /// <param name='vector'></param>
          /// <returns></returns>
          public static bool TryParseConsoleVector(
              string rawConsoleVector, Func<string, string> blankComponentFunc, out Vector3 vector)
          {
              List<string> components = rawConsoleVector.Split(VectorSeparatorChars).ToList();
      
  
gt:             if (components.Count < 1 || components.Count > 3)