public void ConvertTest()
        {
            string msg = "ChineseWordConverter.Convert 測試失敗: ";

            var target = new ChineseWordConverter(
                new ZhuyinReverseConverter(new ZhuyinReverseConversionProvider()));

            ContextTagManager context = new ContextTagManager();

            // 測試結合韻。
            string             text      = "我";
            Stack <char>       charStack = new Stack <char>(text);
            List <BrailleWord> expected  = new List <BrailleWord>();
            BrailleWord        brWord    = new BrailleWord(text, " ㄨㄛˇ", "1208");

            expected.Add(brWord);
            List <BrailleWord> actual = target.Convert(charStack, context);

            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();

            // 測試單音字:要在音調記號前加一個空方。
            text      = "智";
            charStack = new Stack <char>(text);
            brWord    = new BrailleWord(text, "ㄓ  ˋ", "013110");
            expected.Clear();
            expected.Add(brWord);
            actual = target.Convert(charStack, context);
            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();

            // 測試無特殊規則的注音。
            text      = "你";
            charStack = new Stack <char>(text);
            brWord    = new BrailleWord(text, "ㄋㄧ ˇ", "1D2108");
            expected.Clear();
            expected.Add(brWord);
            actual = target.Convert(charStack, context);
            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();

            // 測試標點符號。
            text      = ":";
            charStack = new Stack <char>(text);
            brWord    = new BrailleWord(text, "   ˉ", "1212");
            expected.Clear();
            expected.Add(brWord);
            actual = target.Convert(charStack, context);
            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();

            // 測試全形空白
            text      = " ";
            charStack = new Stack <char>(text);
            brWord    = new BrailleWord(text, "   ˉ", "00");
            expected.Clear();
            expected.Add(brWord);
            actual = target.Convert(charStack, context);
            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();

            // 測試簡體字。
            text      = "实";
            charStack = new Stack <char>(text);
            brWord    = new BrailleWord(text, "ㄕ  ˊ", "0A3102");
            expected.Clear();
            expected.Add(brWord);
            actual = target.Convert(charStack, context);
            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();

            // 測試無法轉換的字元:/
            text      = "/";
            charStack = new Stack <char>(text);
            expected  = null;
            actual    = target.Convert(charStack, context);
            CollectionAssert.AreEqual(expected, actual, msg + text);
            charStack.Clear();
        }
예제 #2
0
        /// <summary>
        /// 把一個明眼字元轉換成點字(BrailleWord)。
        /// 原則上,能夠在這裡處理掉點字特殊規則的,就盡量在這裡處理掉,
        /// 特別是不可斷行分開的點字,例如:一個中文字的所有點字碼、特殊單音字附加的「ㄦ」等等。
        /// </summary>
        /// <param name="reader">字串流。</param>
        /// <returns>若成功轉換成點字,則傳回已轉換的點字 BrailleWord 物件串列,否則傳回 null。</returns>
        /// <remarks>若轉換成功,則已轉換的字元會從串流中讀出,否則該字元仍會保留在串流中。</remarks>
        public List <BrailleWord> ConvertWord(Stack <char> chars)
        {
            List <BrailleWord> brWordList = null;

            // Two-pass 處理(因為有些點字必須再交給其它點字轉換器,故需兩次)。
            for (int pass = 0; pass < 2; pass++)
            {
                if (chars.Count < 1)
                {
                    break;
                }

                // 1. 轉換情境標籤。NOTE: 情境標籤一定要先處理!
                if (chars.Count > 0 && m_ContextTagConverter != null)
                {
                    brWordList = m_ContextTagConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }

                // 2. 轉換座標符號
                if (chars.Count > 0 && m_CoordConverter != null && m_ContextTagManager.IsActive(ContextTagNames.Coordinate))
                {
                    brWordList = m_CoordConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }

                // 3. 轉換數學符號。
                if (chars.Count > 0 && m_ContextTagManager.IsActive(ContextTagNames.Math) && m_MathConverter != null)
                {
                    brWordList = m_MathConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }

                // 4. 轉換表格符號。
                if (chars.Count > 0 && m_ContextTagManager.IsActive(ContextTagNames.Table) && m_TableConverter != null)
                {
                    brWordList = m_TableConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }

                // 5. 轉換音標符號.
                if (chars.Count > 0 && m_ContextTagManager.IsActive(ContextTagNames.Phonetic) && m_PhoneticConverter != null)
                {
                    brWordList = m_PhoneticConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }

                // 6. 轉換中文。
                if (chars.Count > 0 && m_ChineseConverter != null)
                {
                    // 若成功轉換成點字,就不再 pass 給其它轉換器。
                    brWordList = m_ChineseConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }

                // 7. 轉換英文。
                if (chars.Count > 0 && m_EnglishConverter != null)
                {
                    // 若成功轉換成點字,就不再 pass 給其它轉換器。
                    brWordList = m_EnglishConverter.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }
            }

            if (chars.Count > 0)
            {
                // 其它註冊的轉換器。
                foreach (WordConverter cvt in m_Converters)
                {
                    // 若其中一個轉換器成功轉換成點字,就不再 pass 給其它轉換器。
                    brWordList = cvt.Convert(chars, m_ContextTagManager);
                    if (brWordList != null && brWordList.Count > 0)
                    {
                        return(brWordList);
                    }
                }
            }

            // TODO: 碰到無法轉換成點字的情況時,觸發事件通知呼叫端處理,例如:顯示在在訊息視窗裡。

            return(null);
        }