// 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; } } }