internal static Player FindPlayerMatches(Player player, string namePart, SearchOptions options) {
// Repeat last-used player name
if (namePart == "-") {
if (player.LastUsedPlayerName != null) {
namePart = player.LastUsedPlayerName;
} else {
player.Message("Cannot repeat player name: you haven't used any names yet.");
return null;
}
}
// in case someone tries to use the "!" prefix in an online-only search
if (namePart.Length > 0 && namePart[0] == '!')
namePart = namePart.Substring(1);
// Make sure player name is valid
if (!Player.ContainsValidCharacters(namePart)) {
player.MessageInvalidPlayerName(namePart);
return null;
}
Player[] matches = Server.FindPlayers(player, namePart, options);
if (matches.Length == 0) {
player.MessageNoPlayer(namePart);
return null;
} else if (matches.Length > 1) {
player.MessageManyMatches("player", matches);
return null;
} else {
player.LastUsedPlayerName = matches[0].Name;
return matches[0];
}
}
public static PlayerInfo FindByPartialNameOrPrintMatches( [NotNull] Player player, [NotNull] string partialName ) {
if( player == null ) throw new ArgumentNullException( "player" );
if( partialName == null ) throw new ArgumentNullException( "partialName" );
CheckIfLoaded();
if( partialName == "-" ) {
if( player.LastUsedPlayerName != null ) {
partialName = player.LastUsedPlayerName;
} else {
player.Message( "Cannot repeat player name: you haven't used any names yet." );
return null;
}
}
if( !Player.ContainsValidCharacters( partialName ) ) {
player.MessageInvalidPlayerName( partialName );
return null;
}
PlayerInfo target = FindExact( partialName );
if( target == null ) {
PlayerInfo[] targets = FindByPartialName( partialName ).ToArray();
if( targets.Length == 0 ) {
player.MessageNoPlayer( partialName );
return null;
} else if( targets.Length > 1 ) {
Array.Sort( targets, new PlayerInfoComparer( player ) );
player.MessageManyMatches( "player", targets );
return null;
}
target = targets[0];
}
player.LastUsedPlayerName = target.Name;
return target;
}
public static PlayerInfo FindPlayerInfoOrPrintMatches([NotNull] Player player, [NotNull] string namePart,
SearchOptions options)
{
if (player == null)
{
throw new ArgumentNullException("player");
}
if (namePart == null)
{
throw new ArgumentNullException("namePart");
}
CheckIfLoaded();
bool includeSelf = (options & SearchOptions.IncludeSelf) != 0;
bool returnSelf = (options & SearchOptions.ReturnSelfIfOnlyMatch) != 0;
// If name starts with '!', return matches for online players only
if (namePart.Length > 1 && namePart[0] == '!')
{
namePart = namePart.Substring(1);
Player targetPlayer = Server.FindPlayerOrPrintMatches(player, namePart, options);
if (targetPlayer != null)
{
return(targetPlayer.Info);
}
else
{
player.Message("No online players found matching \"{0}\"", namePart);
return(null);
}
}
// Repeat last-used player name
if (namePart == "-")
{
if (player.LastUsedPlayerName != null)
{
namePart = player.LastUsedPlayerName;
}
else
{
player.Message("Cannot repeat player name: you haven't used any names yet.");
return(null);
}
}
// Make sure player name is valid
if (!Player.ContainsValidCharacters(namePart))
{
player.MessageInvalidPlayerName(namePart);
return(null);
}
// Search for exact matches first
PlayerInfo target = FindPlayerInfoExact(namePart);
// If no exact match was found, look for partial matches
if (target == null || target == player.Info && !includeSelf)
{
PlayerInfo[] targets = FindPlayers(namePart);
if (!includeSelf)
{
// special handling if IncludeSelf flag is not set
if (targets.Length > 1)
{
targets = targets.Where(p => p != player.Info).ToArray();
}
else if (!returnSelf && targets.Length == 1 && targets[0] == player.Info)
{
// special handling if ReturnSelfIfOnlyMatch flag is not set
targets = new PlayerInfo[0];
}
}
if (targets.Length == 0)
{
// No matches
player.MessageNoPlayer(namePart);
return(null);
}
else if (targets.Length > 1)
{
// More than one match
Array.Sort(targets, new PlayerInfoComparer(player));
player.MessageManyMatches("player", targets.Take(MatchesToPrint).ToArray());
return(null);
} // else: one match!
target = targets[0];
}
// If a single name has been found, set it as LastUsedPlayerName
if (includeSelf || target != player.Info)
{
player.LastUsedPlayerName = target.Name;
}
return(target);
}
public static PlayerInfo FindPlayerInfoOrPrintMatches([NotNull] Player player, [NotNull] string partialName)
{
if (player == null)
{
throw new ArgumentNullException("player");
}
if (partialName == null)
{
throw new ArgumentNullException("partialName");
}
CheckIfLoaded();
// If name starts with '!', return matches for online players only
if (partialName.Length > 1 && partialName[0] == '!')
{
partialName = partialName.Substring(1);
Player targetPlayer = Server.FindPlayerOrPrintMatches(player, partialName, false, true);
if (targetPlayer != null)
{
return(targetPlayer.Info);
}
else
{
player.Message("No online players found matching \"{0}\"", partialName);
return(null);
}
}
// Repeat last-used player name
if (partialName == "-")
{
if (player.LastUsedPlayerName != null)
{
partialName = player.LastUsedPlayerName;
}
else
{
player.Message("Cannot repeat player name: you haven't used any names yet.");
return(null);
}
}
// Make sure player name is valid
if (!Player.ContainsValidCharacters(partialName))
{
player.MessageInvalidPlayerName(partialName);
return(null);
}
// Search for exact matches first
PlayerInfo target = FindPlayerInfoExact(partialName);
// If no exact match was found, look for partial matches
if (target == null)
{
PlayerInfo[] targets = FindPlayers(partialName);
if (targets.Length == 0)
{
// No matches
player.MessageNoPlayer(partialName);
return(null);
}
else if (targets.Length > 1)
{
// More than one match
Array.Sort(targets, new PlayerInfoComparer(player));
player.MessageManyMatches("player", targets.Take(25).ToArray());
return(null);
} // else: one match!
target = targets[0];
}
// If a single name has been found, set it as LastUsedPlayerName
player.LastUsedPlayerName = target.Name;
return(target);
}
