深度优先

【常用代码】常用的一些代码块

发表于 2017-11-02 分类于常用代码
本文字数： 8.1k 阅读时长 ≈ 7 分钟

一、记录日志

protected override void OnStart(string[] args)  
{  
    this.WriteLog("\n当前时间：" + DateTime.Now.ToString("yyyy-MM-dd hh-mm-ss") + "\n");  
    this.WriteLog("客户端数据同步服务：【服务启动】");  
}  

protected override void OnStop()  
{  
    this.WriteLog("\n当前时间：" + DateTime.Now.ToString("yyyy-MM-dd hh-mm-ss")+ "\n");  
    this.WriteLog("客户端数据同步服务：【服务停止】");  
}  
protected override void OnShutdown()  
{  
    this.WriteLog("\n当前时间：" + DateTime.Now.ToString("yyyy-MM-dd hh-mm-ss") + "\n");  
    this.WriteLog("客户端数据同步服务：【计算机关闭】");  
}  

#region 记录日志  
/// <summary>  
/// 记录日志  
/// </summary>  
/// <param name="msg"></param>  
private void WriteLog(string msg)  
{  

    //string path = @"C:\log.txt";  

    //该日志文件会存在windows服务程序目录下  
    string path = AppDomain.CurrentDomain.BaseDirectory + "\\log.txt";  
    FileInfo file = new FileInfo(path);  
    if (!file.Exists)  
    {  
        FileStream fs;  
        fs = File.Create(path);  
        fs.Close();  
    }  

    using (FileStream fs = new FileStream(path, FileMode.Append, FileAccess.Write))  
    {  
        using (StreamWriter sw = new StreamWriter(fs))  
        {  
            sw.WriteLine(DateTime.Now.ToString() + "   " + msg);  
        }  
    }  
}  
#endregion

二、生成二维码

/// <summary>
/// 生成用户名片
/// </summary>
/// <returns></returns>
public ActionResult creQRcode()
{
    string name = Request["name"]==null? "暂无" : Request["name"];
    string tel = Request["phone"] == null ? "400 XXXX 421" : Request["phone"];
    string TITLE = Request["phone"] == null ? "400 XXXX 421" : Request["phone"];
    string ORG = Request["userTypeName"] == null ? "暂无" : Request["userTypeName"];
    string ADR = Request["address"] == null  ? "XXXXX" : Request["address"];
    string URL = "http://www.yhfy.cn/";
    string EMAIL = Request["email"] == null ? "bXXXXX1@126.com" : Request["email"];
    string comment = Request["comment"] == null ? "无" : Request["comment"];

    StringBuilder card = new StringBuilder();
    card.Append("BEGIN:VCARD");
    card.Append("\r\nFN:" + name);//姓名
    card.Append("\r\nTEL;CELL:" + tel);//手机号
    card.Append("\r\nTITLE:" + TITLE);//
    card.Append("\r\nORG:" + ORG+ "-" + comment);
    card.Append("\r\nTEL;WORK:" + "400-6690421");
    card.Append("\r\nADR;WORK:" + ADR);
    card.Append("\r\nURL:" + URL);
    card.Append("\r\nEMAIL;WORK:" + EMAIL);
    card.Append("\r\nEND:VCARD\r\n");

    Bitmap bmp = GetTwoDimensionCode(card.ToString(), string.Empty, 200, 200, "微软雅黑");

    string path = "~/Upload/MyQRCoed/";
    string path2 = Request.MapPath(path);
    if (!Directory.Exists(path2))
    {
        Directory.CreateDirectory(path2);
    }
    string guid = Guid.NewGuid().ToString();
    string newPath = path2 + guid + ".jpg";
    bmp.Save(newPath, ImageFormat.Jpeg);
    string src = "../Upload/MyQRCoed/" + guid + ".jpg";
    return Content(src);

}

/// <summary>
/// 绘制二维码
/// </summary>
/// <param name="strSource"></param>
/// <param name="text"></param>
/// <param name="width"></param>
/// <param name="height"></param>
/// <param name="fontName"></param>
/// <returns></returns>
public static Bitmap GetTwoDimensionCode(string strSource, string text, int width, int height, string fontName)
{
    // 创建Bitmap对象
    Bitmap bmp = new Bitmap(width, height);
    // 从image创建 Graphics对象
    Graphics objGraphics = Graphics.FromImage(bmp);
    // 填上背景色
    objGraphics.FillRectangle(Brushes.White, 0, 0, bmp.Width, bmp.Height);
    // 
    ThoughtWorks.QRCode.Codec.QRCodeEncoder qrCodeEncoder =
        new ThoughtWorks.QRCode.Codec.QRCodeEncoder();
    // 设置编码方法
    qrCodeEncoder.QRCodeEncodeMode =
        ThoughtWorks.QRCode.Codec.QRCodeEncoder.ENCODE_MODE.BYTE;
    // 设置大小
    qrCodeEncoder.QRCodeScale = 3;
    // 适用于信息量较少的情形，图像越小保存的信息量越少
    // qrCodeEncoder.QRCodeScale = 4;
    // 设置版本
    qrCodeEncoder.QRCodeVersion = 0;
    // 设置错误校验的级别，正因为二维码有纠错能力，才能够加入logo
    qrCodeEncoder.QRCodeErrorCorrect =
        ThoughtWorks.QRCode.Codec.QRCodeEncoder.ERROR_CORRECTION.M;
    Image image = qrCodeEncoder.Encode(strSource, Encoding.GetEncoding("utf-8"));
    // 写入二维码
    int x = (int)(width - image.Width) / 2;
    int y = (int)(height - image.Height) / 2;
    objGraphics.DrawImage(image, new Point(x, y));
    // 添加Logo图标
    image = MvcTMM.Properties.Resources.logo;
    x = (int)(width - image.Width) / 2;
    y = (int)(height - image.Height) / 2;
    objGraphics.DrawImage(image, new Point(x, y));
    // 写入字符串
    //objGraphics.DrawString(text, new Font(fontName, 13, FontStyle.Bold), 
    //    Brushes.Black, new PointF(43, 15));
    return bmp;
}

三、图片加水印

using System;
using System.Collections;
using System.Collections.Generic;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Drawing.Imaging;
using System.IO;
using System.Linq;
using System.Web;

namespace MvcTMM.BaseCode
{

    /// <summary>
    /// 调用方法：传入图片的路径，添加水印的文字
    /// Img.LetterWatermark(@"C:\Users\Administrator\Desktop\Img加水印\Img加水印\bin\1.jpg", "YHFY:种植前田地状态");
    /// </summary>
    
    public class ImgAddText
    {
        #region 文字水印
        ///// <summary>
        ///// 文字水印处理方法
        ///// </summary>
        ///// <param name="path">图片路径（绝对路径）</param>
        ///// <param name="letter">水印文字</param>
        ///// <param name="location">水印位置</param>
        ///// <param name="size">字体大小</param>
        /// <returns>图片路径</returns>
        public static string LetterWatermark(string path, string letter, string location = "LB", int size = 20)
        {
            #region
            //水印的颜色样式
            Color color = System.Drawing.Color.FromArgb(224, 207, 201);
            //添加时间后缀
            letter += " | " + DateTime.Now.ToLocalTime();

            string kz_name = Path.GetExtension(path);
            if (kz_name == ".jpg" || kz_name == ".bmp" || kz_name == ".jpeg" || kz_name == ".png")
            {
                DateTime time = DateTime.Now;
                string filename = "" + time.Year.ToString() + time.Month.ToString() + time.Day.ToString() + time.Hour.ToString() + time.Minute.ToString() + time.Second.ToString() + time.Millisecond.ToString();
                Image img = Bitmap.FromFile(path);
                Graphics gs = Graphics.FromImage(img);
                ArrayList loca = GetLocation(location, img, size, letter.Length);
                Font font = new Font("微软雅黑", size);
                Brush br = new SolidBrush(color);
                gs.DrawString(letter, font, br, float.Parse(loca[0].ToString()), float.Parse(loca[1].ToString()));
                gs.Dispose();
                string newpath = Path.GetDirectoryName(path) + filename + kz_name;
                img.Save(newpath);
                img.Dispose();
                File.Copy(newpath, path, true);
                if (File.Exists(newpath))
                {
                    File.Delete(newpath);
                }
            }
            return path;
            #endregion
        }

        /// <summary>
        /// 文字水印位置的方法
        /// </summary>
        /// <param name="location">位置代码</param>
        /// <param name="img">图片对象</param>
        /// <param name="width">宽(当水印类型为文字时,传过来的就是字体的大小)</param>
        /// <param name="height">高(当水印类型为文字时,传过来的就是字符的长度)</param>
        private static ArrayList GetLocation(string location, Image img, int width, int height)
        {
            ArrayList loca = new ArrayList();
            float x = 10;
            float y = 10;

            if (location == "LT")
            {
                loca.Add(x);
                loca.Add(y);
            }
            else if (location == "T")
            {
                x = img.Width / 2 - (width * height) / 2;
                loca.Add(x);
                loca.Add(y);
            }
            else if (location == "RT")
            {
                x = img.Width - width * height;
            }
            else if (location == "LC")
            {
                y = img.Height / 2;
            }
            else if (location == "C")
            {
                x = img.Width / 2 - (width * height) / 2;
                y = img.Height / 2;
            }
            else if (location == "RC")
            {
                x = img.Width - height;
                y = img.Height / 2;
            }
            else if (location == "LB")
            {
                y = img.Height - width - 15;
            }
            else if (location == "B")
            {
                x = img.Width / 2 - (width * height) / 2;
                y = img.Height - width - 5;
            }
            else
            {
                x = img.Width - width * height;
                y = img.Height - width - 5;
            }
            loca.Add(x);
            loca.Add(y);
            return loca;
        }
        #endregion
    }
}

【Asp.Net】大白话WebSocket原理

发表于 2017-10-29 分类于编程路上
本文字数： 4.9k 阅读时长 ≈ 4 分钟

转自：http://blog.csdn.net/frank_good/article/details/50856585

偶然在知乎上看到一篇回帖，瞬间觉得之前看的那么多资料都不及这一篇回帖让我对 websocket 的认识深刻有木有。所以转到我博客里，分享一下。比较喜欢看这种博客，读起来很轻松，不枯燥，没有布道师的阵仗，纯粹为分享。废话这么多了，最后再赞一个~

一、websocket与http

WebSocket是HTML5出的东西（协议），也就是说HTTP协议没有变化，或者说没关系，但HTTP是不支持持久连接的（长连接，循环连接的不算）

首先HTTP有 1.1 和 1.0 之说，也就是所谓的 keep-alive ，把多个HTTP请求合并为一个，但是 Websocket 其实是一个新协议，跟HTTP协议基本没有关系，只是为了兼容现有浏览器的握手规范而已，也就是说它是HTTP协议上的一种补充可以通过这样一张图理解

有交集，但是并不是全部。

另外Html5是指的一系列新的API，或者说新规范，新技术。Http协议本身只有1.0和1.1，而且跟Html本身没有直接关系。。通俗来说，你可以用HTTP协议传输非Html数据，就是这样=。=

再简单来说，层级不一样。

二、Websocket是什么样的协议，具体有什么优点

首先，Websocket是一个持久化的协议，相对于HTTP这种非持久的协议来说。简单的举个例子吧，用目前应用比较广泛的PHP生命周期来解释。

HTTP的生命周期通过 Request 来界定，也就是一个 Request 一个 Response ，那么在 HTTP1.0 中，这次HTTP请求就结束了。

在HTTP1.1中进行了改进，使得有一个keep-alive，也就是说，在一个HTTP连接中，可以发送多个Request，接收多个Response。但是请记住 Request = Response ，在HTTP中永远是这样，也就是说一个request只能有一个response。而且这个response也是被动的，不能主动发起。

教练，你BB了这么多，跟Websocket有什么关系呢？_(:з」∠)_好吧，我正准备说Websocket呢。。

首先Websocket是基于HTTP协议的，或者说借用了HTTP的协议来完成一部分握手。

首先我们来看个典型的 Websocket 握手（借用Wikipedia的。。）

GET /chat HTTP/1.1 Host: server.example.com Upgrade: websocket Connection: Upgrade Sec-WebSocket-Key: x3JJHMbDL1EzLkh9GBhXDw== Sec-WebSocket-Protocol: chat, superchat Sec-WebSocket-Version: 13 Origin: http://example.com

熟悉HTTP的童鞋可能发现了，这段类似HTTP协议的握手请求中，多了几个东西。我会顺便讲解下作用。

1	Upgrade: websocket Connection: Upgrade

这个就是Websocket的核心了，告诉 Apache 、 Nginx 等服务器：注意啦，我发起的是Websocket协议，快点帮我找到对应的助理处理~不是那个老土的HTTP。

1	Sec-WebSocket-Key: x3JJHMbDL1EzLkh9GBhXDw== Sec-WebSocket-Protocol: chat, superchat Sec-WebSocket-Version: 13

首先， Sec-WebSocket-Key 是一个 Base64 encode 的值，这个是浏览器随机生成的，告诉服务器：泥煤，不要忽悠窝，我要验证尼是不是真的是Websocket助理。

然后， Sec_WebSocket-Protocol 是一个用户定义的字符串，用来区分同URL下，不同的服务所需要的协议。简单理解：今晚我要服务A，别搞错啦~

最后， Sec-WebSocket-Version 是告诉服务器所使用的 Websocket Draft （协议版本），在最初的时候，Websocket协议还在 Draft 阶段，各种奇奇怪怪的协议都有，而且还有很多期奇奇怪怪不同的东西，什么Firefox和Chrome用的不是一个版本之类的，当初Websocket协议太多可是一个大难题。。不过现在还好，已经定下来啦~~大家都使用的一个东西~~ 脱水：服务员，我要的是13岁的噢→_→

然后服务器会返回下列东西，表示已经接受到请求，成功建立Websocket啦！

1	HTTP/1.1 101 Switching Protocols Upgrade: websocket Connection: Upgrade Sec-WebSocket-Accept: HSmrc0sMlYUkAGmm5OPpG2HaGWk= Sec-WebSocket-Protocol: chat

这里开始就是HTTP最后负责的区域了，告诉客户，我已经成功切换协议啦~

1	Upgrade: websocket Connection: Upgrade

依然是固定的，告诉客户端即将升级的是 Websocket 协议，而不是mozillasocket，lurnarsocket或者shitsocket。

然后， Sec-WebSocket-Accept 这个则是经过服务器确认，并且加密过后的 Sec-WebSocket-Key 。服务器：好啦好啦，知道啦，给你看我的ID CARD来证明行了吧。。

后面的， Sec-WebSocket-Protocol 则是表示最终使用的协议。

至此，HTTP已经完成它所有工作了，接下来就是完全按照Websocket协议进行了。具体的协议就不在这阐述了。

——————技术解析部分完毕——————

你TMD又BBB了这么久，那到底Websocket有什么鬼用， http long poll ，或者 ajax轮询 不都可以实现实时信息传递么。

好好好，年轻人，那我们来讲一讲Websocket有什么用。来给你吃点胡（苏）萝（丹）卜（红）

三、Websocket的作用

在讲Websocket之前，我就顺带着讲下 long poll 和 ajax轮询 的原理。

ajax轮询

ajax轮询的原理非常简单，让浏览器隔个几秒就发送一次请求，询问服务器是否有新信息。

场景再现：

客户端：啦啦啦，有没有新信息(Request)

服务端：没有（Response）

客户端：啦啦啦，有没有新信息(Request)

服务端：没有。。（Response）

客户端：啦啦啦，有没有新信息(Request)

服务端：你好烦啊，没有啊。。（Response）

客户端：啦啦啦，有没有新消息（Request）

服务端：好啦好啦，有啦给你。（Response）

客户端：啦啦啦，有没有新消息（Request）

服务端：。。。。。没。。。。没。。。没有（Response） —- loop

long poll

long poll 其实原理跟 ajax轮询 差不多，都是采用轮询的方式，不过采取的是阻塞模型（一直打电话，没收到就不挂电话），也就是说，客户端发起连接后，如果没消息，就一直不返回Response给客户端。直到有消息才返回，返回完之后，客户端再次建立连接，周而复始。

场景再现：

客户端：啦啦啦，有没有新信息，没有的话就等有了才返回给我吧（Request）

服务端：额。。等待到有消息的时候。。来给你（Response）

客户端：啦啦啦，有没有新信息，没有的话就等有了才返回给我吧（Request） -loop

从上面可以看出其实这两种方式，都是在不断地建立HTTP连接，然后等待服务端处理，可以体现HTTP协议的另外一个特点，被动性。

何为被动性呢，其实就是，服务端不能主动联系客户端，只能有客户端发起。

简单地说就是，服务器是一个很懒的冰箱（这是个梗）（不会、不能主动发起连接），但是上司有命令，如果有客户来，不管多么累都要好好接待。

说完这个，我们再来说一说上面的缺陷（原谅我废话这么多吧OAQ）

从上面很容易看出来，不管怎么样，上面这两种都是非常消耗资源的。

ajax轮询需要服务器有很快的处理速度和资源。（速度）long poll 需要有很高的并发，也就是说同时接待客户的能力。（场地大小）

所以 ajax轮询 和 long poll 都有可能发生这种情况。

客户端：啦啦啦啦，有新信息么？

服务端：月线正忙，请稍后再试（503 Server Unavailable）

客户端：。。。。好吧，啦啦啦，有新信息么？

服务端：月线正忙，请稍后再试（503 Server Unavailable）

客户端：然后服务端在一旁忙的要死：冰箱，我要更多的冰箱！更多。。更多。。（我错了。。这又是梗。。）

言归正传，我们来说Websocket吧

通过上面这个例子，我们可以看出，这两种方式都不是最好的方式，需要很多资源。

一种需要更快的速度，一种需要更多的’电话’。这两种都会导致’电话’的需求越来越高。

哦对了，忘记说了HTTP还是一个状态协议。

通俗的说就是，服务器因为每天要接待太多客户了，是个健忘鬼，你一挂电话，他就把你的东西全忘光了，把你的东西全丢掉了。你第二次还得再告诉服务器一遍。

所以在这种情况下出现了，Websocket出现了。他解决了HTTP的这几个难题。首先，被动性，当服务器完成协议升级后（HTTP->Websocket），服务端就可以主动推送信息给客户端啦。所以上面的情景可以做如下修改。

客户端：啦啦啦，我要建立Websocket协议，需要的服务：chat，Websocket协议版本：17（HTTP Request）

服务端：ok，确认，已升级为Websocket协议（HTTP Protocols Switched）

客户端：麻烦你有信息的时候推送给我噢。。

服务端：ok，有的时候会告诉你的。

服务端：balabalabalabala

服务端：哈哈哈哈哈啊哈哈哈哈

服务端：笑死我了哈哈哈哈哈哈哈

就变成了这样，只需要经过一次HTTP请求，就可以做到源源不断的信息传送了。（在程序设计中，这种设计叫做回调，即：你有信息了再来通知我，而不是我傻乎乎的每次跑来问你）

这样的协议解决了上面同步有延迟，而且还非常消耗资源的这种情况。那么为什么他会解决服务器上消耗资源的问题呢？

其实我们所用的程序是要经过两层代理的，即HTTP协议在Nginx等服务器的解析下，然后再传送给相应的Handler（PHP等）来处理。简单地说，我们有一个非常快速的 接线员（Nginx） ，他负责把问题转交给相应的 客服（Handler） 。

本身接线员基本上速度是足够的，但是每次都卡在客服（Handler）了，老有客服处理速度太慢。，导致客服不够。Websocket就解决了这样一个难题，建立后，可以直接跟接线员建立持久连接，有信息的时候客服想办法通知接线员，然后接线员在统一转交给客户。

这样就可以解决客服处理速度过慢的问题了。

同时，在传统的方式上，要不断的建立，关闭HTTP协议，由于HTTP是非状态性的，每次都要重新传输 identity info （鉴别信息），来告诉服务端你是谁。

虽然接线员很快速，但是每次都要听这么一堆，效率也会有所下降的，同时还得不断把这些信息转交给客服，不但浪费客服的处理时间，而且还会在网路传输中消耗过多的流量/时间。

但是Websocket只需要一次HTTP握手，所以说整个通讯过程是建立在一次连接/状态中，也就避免了HTTP的非状态性，服务端会一直知道你的信息，直到你关闭请求，这样就解决了接线员要反复解析HTTP协议，还要查看identity info的信息。

同时由客户主动询问，转换为服务器（推送）有信息的时候就发送（当然客户端还是等主动发送信息过来的。。），没有信息的时候就交给接线员（Nginx），不需要占用本身速度就慢的客服（Handler）了

——————–

至于怎么在不支持Websocket的客户端上使用Websocket。。答案是：不能

但是可以通过上面说的 long poll 和 ajax 轮询 来模拟出类似的效果

【MVC】获取项目中所有的控制器-试图

发表于 2017-10-26 分类于编程路上
本文字数： 3.6k 阅读时长 ≈ 3 分钟

在C#中，实现动态获取类和方法主要通过反射来实现，要引用System.Reflection。

方法一：

public ActionResult GetControllerAndAction()
{
    //创建控制器类型列表
    List<Type> controllerTypes = new List<Type>();
    
    //加载程序集
    var assembly = Assembly.Load("MPMS");

    //获取程序集下所有的类，通过Linq筛选继承IController类的所有类型
    controllerTypes.AddRange(assembly.GetTypes().Where(type => typeof(IController).IsAssignableFrom(type) && type.Name != "ErrorController"));

    //创建动态字符串，拼接json数据    注：现在json类型传递数据比较流行，比xml简洁
    StringBuilder jsonBuilder = new StringBuilder();    
    jsonBuilder.Append("[");

    //遍历控制器类
    foreach (var controller in controllerTypes)
    {
        jsonBuilder.Append("{\"controllerName\":\"");
        jsonBuilder.Append(controller.Name);
        jsonBuilder.Append("\",\"controllerDesc\":\"");
        jsonBuilder.Append((controller.GetCustomAttribute(typeof(DescriptionAttribute)) as DescriptionAttribute) == null ? "" : (controller.GetCustomAttribute(typeof(DescriptionAttribute)) as DescriptionAttribute).Description);
        
        //获取对控制器的描述Description
        jsonBuilder.Append("\",\"action\":[");

        //获取控制器下所有返回类型为ActionResult的方法，对MVC的权限控制只要限制所以的前后台交互请求就行，统一为ActionResult
        var actions = controller.GetMethods().Where(method => method.ReturnType.Name == "ActionResult");    
        foreach (var action in actions)
        {
            jsonBuilder.Append("{\"actionName\":\"");
            jsonBuilder.Append(action.Name);
            jsonBuilder.Append("\",\"actionDesc\":\"");
            jsonBuilder.Append((action.GetCustomAttribute(typeof(DescriptionAttribute)) as DescriptionAttribute) == null ? "" : (action.GetCustomAttribute(typeof(DescriptionAttribute)) as DescriptionAttribute).Description);    //获取对Action的描述
            jsonBuilder.Append("\"},");
        }
        jsonBuilder.Remove(jsonBuilder.Length - 1, 1);
        jsonBuilder.Append("]},");
    }
    jsonBuilder.Remove(jsonBuilder.Length - 1, 1);
    jsonBuilder.Append("]");
    return Content(jsonBuilder.ToString());
}

方法二：

/// <summary>
/// 通过反射得到所有可用的action
/// </summary>
/// <returns></returns>
public static List<string> GetALLPageByReflection()
{
    List<string> actions = new List<string>();
    var asm = System.Reflection.Assembly.GetExecutingAssembly();
    System.Collections.Generic.List<Type> typeList = new List<Type>();
    var types = asm.GetTypes();
    foreach (Type type in types)
    {
        string s = type.FullName.ToLower();
        if (type.Name.StartsWith("AccountCont")) continue;
        if (s.StartsWith("mvctmm.controllers.") && s.EndsWith("controller"))
            typeList.Add(type);
    }
    typeList.Sort(delegate (Type type1, Type type2) { return type1.FullName.CompareTo(type2.FullName); });
    foreach (Type type in typeList)
    {
        //Response.Write(type.Name.Replace("Controller","") + "<br/>\n");
        System.Reflection.MemberInfo[] members = type.FindMembers(System.Reflection.MemberTypes.Method,
        System.Reflection.BindingFlags.Public |
        System.Reflection.BindingFlags.Static |
        System.Reflection.BindingFlags.NonPublic |        //【位屏蔽】
        System.Reflection.BindingFlags.Instance |
        System.Reflection.BindingFlags.DeclaredOnly,
        Type.FilterName, "*");
        foreach (var m in members)
        {
            if (m.DeclaringType.Attributes.HasFlag(System.Reflection.TypeAttributes.Public) != true)
                continue;
            string controller = type.Name.Replace("Controller", "");
            string action = m.Name;
            string url = "/" + controller + "/" + action;
            actions.Add(url);
        }
    }
    return actions;
}