//CruiseControl is open source software and is developed and maintained by a group of dedicated volunteers.
//CruiseControl is distributed under a BSD-style license.
//http://cruisecontrol.sourceforge.net/
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Text.RegularExpressions;
namespace ThoughtWorks.CruiseControl.Core.Util
{
///
/// Class with handy stirng routines
///
public class StringUtil
{
private static readonly Regex urlEncodeRegex = new Regex("[^a-zA-Z0-9\\.\\-_~]", RegexOptions.Compiled);
// public for testing only
public const string DEFAULT_DELIMITER = ",";
///
/// Correctly encode a name for a URL.
///
/// The name to encode.
/// The encoded name.
///
///
/// HttpUtility.UrlEncode does not correctly encode for a URL, spaces get converted into
/// pluses, which can cause security errors.
///
///
/// This method will encode characters according to RFC 3986. This means only the following
/// characters are allowed un-encoded:
///
///
/// A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s
/// t u v w x y z 0 1 2 3 4 5 6 7 8 9 - _ . ~
///
///
/// However, since the encoding only uses two-hex digits, it is not possible to encode non-ASCII
/// characters using this approach. Therefore we are using the RFC 3986 recommendation and assuming
/// the string will be using UTF-8 encoding and leaving the characters as they are.
///
///
public static string UrlEncodeName(string name)
{
var encodedName = urlEncodeRegex.Replace(name, (match) =>
{
var charValue = (int)match.Value[0];
var value = charValue >= 255 ? match.Value : "%" + string.Format("{0:x2}", charValue);
return value;
});
return encodedName;
}
}
}