// Copyright (c) 2010-2013 AlphaSierraPapa for the SharpDevelop Team
//
// Permission is hereby granted, free of charge, to any person obtaining a copy of this
// software and associated documentation files (the "Software"), to deal in the Software
// without restriction, including without limitation the rights to use, copy, modify, merge,
// publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
// to whom the Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all copies or
// substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
// FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
using System;
using System.Globalization;
using System.ComponentModel;
namespace Unity.CodeEditor.Document
{
///
/// A line/column position.
/// Text editor lines/columns are counted started from one.
///
///
/// The document provides the methods and
/// to convert between offsets and TextLocations.
///
[TypeConverter(typeof(TextLocationConverter))]
internal struct TextLocation : IComparable, IEquatable
{
///
/// Represents no text location (0, 0).
///
internal static readonly TextLocation Empty = new TextLocation(0, 0);
///
/// Creates a TextLocation instance.
///
internal TextLocation(int line, int column)
{
Line = line;
Column = column;
}
///
/// Gets the line number.
///
internal int Line { get; }
///
/// Gets the column number.
///
internal int Column { get; }
///
/// Gets whether the TextLocation instance is empty.
///
internal bool IsEmpty => Column <= 0 && Line <= 0;
///
/// Gets a string representation for debugging purposes.
///
public override string ToString()
{
return string.Format(CultureInfo.InvariantCulture, "(Line {1}, Col {0})", Column, Line);
}
///
/// Gets a hash code.
///
public override int GetHashCode()
{
return unchecked(191 * Column.GetHashCode() ^ Line.GetHashCode());
}
///
/// Equality test.
///
public override bool Equals(object obj)
{
if (!(obj is TextLocation)) return false;
return (TextLocation)obj == this;
}
///
/// Equality test.
///
public bool Equals(TextLocation other)
{
return this == other;
}
///
/// Equality test.
///
public static bool operator ==(TextLocation left, TextLocation right)
{
return left.Column == right.Column && left.Line == right.Line;
}
///
/// Inequality test.
///
public static bool operator !=(TextLocation left, TextLocation right)
{
return left.Column != right.Column || left.Line != right.Line;
}
///
/// Compares two text locations.
///
public static bool operator <(TextLocation left, TextLocation right)
{
if (left.Line < right.Line)
return true;
if (left.Line == right.Line)
return left.Column < right.Column;
return false;
}
///
/// Compares two text locations.
///
public static bool operator >(TextLocation left, TextLocation right)
{
if (left.Line > right.Line)
return true;
if (left.Line == right.Line)
return left.Column > right.Column;
return false;
}
///
/// Compares two text locations.
///
public static bool operator <=(TextLocation left, TextLocation right)
{
return !(left > right);
}
///
/// Compares two text locations.
///
public static bool operator >=(TextLocation left, TextLocation right)
{
return !(left < right);
}
///
/// Compares two text locations.
///
public int CompareTo(TextLocation other)
{
if (this == other)
return 0;
if (this < other)
return -1;
return 1;
}
}
///
/// Converts strings of the form '0+[;,]0+' to a .
///
internal class TextLocationConverter : TypeConverter
{
///
public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
{
return sourceType == typeof(string);
}
///
public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)
{
return destinationType == typeof(TextLocation);
}
///
public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
{
var s = value as string;
var parts = s?.Split(';', ',');
if (parts?.Length == 2)
{
return new TextLocation(int.Parse(parts[0], culture), int.Parse(parts[1], culture));
}
throw new InvalidOperationException();
}
///
public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
{
if (value is TextLocation loc && destinationType == typeof(string))
{
return loc.Line.ToString(culture) + ";" + loc.Column.ToString(culture);
}
throw new InvalidOperationException();
}
}
///
/// An (Offset,Length)-pair.
///
internal interface ISegment
{
///
/// Gets the start offset of the segment.
///
int Offset { get; }
///
/// Gets the length of the segment.
///
/// For line segments (IDocumentLine), the length does not include the line delimeter.
int Length { get; }
///
/// Gets the end offset of the segment.
///
/// EndOffset = Offset + Length;
int EndOffset { get; }
}
///
/// Extension methods for .
///
internal static class SegmentExtensions
{
///
/// Gets whether fully contains the specified segment.
///
///
/// Use segment.Contains(offset, 0) to detect whether a segment (end inclusive) contains offset;
/// use segment.Contains(offset, 1) to detect whether a segment (end exclusive) contains offset.
///
internal static bool Contains(this ISegment segment, int offset, int length)
{
return segment.Offset <= offset && offset + length <= segment.EndOffset;
}
///
/// Gets whether fully contains the specified segment.
///
internal static bool Contains(this ISegment thisSegment, ISegment segment)
{
return segment != null && thisSegment.Offset <= segment.Offset && segment.EndOffset <= thisSegment.EndOffset;
}
}
}