顾名思义，‘pinyin’ 是一个将中文字符转换成汉语拼音的 R 语言包。除了拼音，它还能转换成四角号码、五笔字型，或者用户自定义的任何符号。

至于什么是汉语拼音，就不用多做解释了。除中国大陆地区外，新加坡、马来西亚、菲律宾和美国唐人街等，都在使用汉语拼音。台湾自2008年开始，中文译音使用原则也采用汉语拼音。

五笔字型是除汉语拼音外常用的中文输入法。四角号码是除拼音、部首检字法外重要的检字法。

R ‘pinyin’ 包相当于一个字典。如果掌握了它的用法，你会发现，它不只是个字典。

使用 ‘pinyin’ 包之前，必须安装 R 语言。R 是免费、开源、跨平台的编程语言，对像我这样的非专业程序员非常友好。

R 语言的安装见官方平台 Comprehensive R Archive Network (CRAN)，或者参考相关教材（例如我写的 《*学 R：零基础学习 R 语言*》)。为了保证本教程的完整性，这里简述一下 Windows 操作系统里 R 语言的安装。

R 默认的编辑器简陋得不像话。我们大力推荐用户使用第三方编辑器，例如免费跨平台的 *RStudio IDE*。访问RStudio 的下载页面，根据你的操作系统来选择合适的软件包。这里，我们下载 ‘RStudio 1.1.463 - Windows Vista/7/8/10’。双击下载得到的文件，一路点击 ‘Next…’ 就行了。.

图 1 展示了 RStudio 的用户界面。

‘pinyin’ 在 CRAN 已上线，可以在 RStudio 里使用常规的 R 包安装方式进行安装稳定版：

或者安装开发版，比稳定版要新：

然后，使用下面的语句加载：

用户可以使用下面的命令，来查看 ‘pinyin’ 包的所有函数和他们的参数：

函数的用法总结在图 2 里。

img(‘pinyin-functions.png’)

在这些函数里, py() 是主函数。初学者可以通过这个函数来对 ‘pinyin’ 包有个初步印象。下面详细介绍这个函数的用法。

py() 函数最简单的用法是转换单个的汉字，例如：

练习 1：将你的姓的汉字转成拼音。

待转换的汉字可以是个长度大于 1 的向量。例如：

也可以是个字符数大于 1 的字符串：

体会一下上面两个例子的差别。

如果要转换的汉字保存在表格里，py() 可以直接转换整列的汉字，就像这样：