Module:Convert character width

Module documentation[view] [edit] [history] [purge]

This module converts a limited set of characters between halfwidth and fullwidth forms.

Usage

From half-width to full-width

{{#invoke:convert character width|full|text to convert}}

From full-width to half-width

{{#invoke:convert character width|half|text to convert}}

Examples

• {{#invoke:convert character width|full|some text 0123456789}} → ｓｏｍｅ　ｔｅｘｔ　０１２３４５６７８９
• {{#invoke:convert character width|half|ｓｏｍｅ　ｔｅｘｔ　０１２３４５６７８９}} → some text 0123456789

Support

Care should be taken when using this module with Hangul and katakana; as of September 2013 there is only limited support for katakana and no support for Hangul. Some of the more obscure punctuation characters are also not yet supported.

Data

The character data used by the module is located at Module:Convert character width/data. Fixes and updates to the data set are welcomed enthusiastically.

The above documentation is transcluded from Module:Convert character width/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

-- This module converts support characters from half-width to full-width, and vice versa.
-- See [[Halfwidth and fullwidth forms]] for an explanation of half- and full-width characters.

-- @todo FIXME: Needs more characters adding, needs support for diacritic marks.

local data = mw.loadData( 'Module:Convert character width/data' )

local p = {}

-- Converts one half-width character to one full-width character.
local function getFull( s )
    return data[ s ] or s
end

-- Converts one full-width character to one half-width character.
local function getHalf( s )
    for half, full in pairs( data ) do
        if s == full then
            return half
        end
    end
    return s
end

-- Converts multiple half-width characters to full-width characters.
function p.full( frame )
    local s = type( frame ) == 'table' and frame.args and frame.args[ 1 ] or frame
    s = type( s ) == 'number' and tostring( s ) or s
    if type( s ) ~= 'string' then return end
    return ( mw.ustring.gsub( s, '.', getFull ) )
end

-- Converts multiple full-width characters to half-width characters.
function p.half( frame )
    local s = type( frame ) == 'table' and frame.args and frame.args[ 1 ] or frame
    s = type( s ) == 'number' and tostring( s ) or s
    if type( s ) ~= 'string' then return end
    return ( mw.ustring.gsub( s, '.', getHalf ) )
end

return p