<?php

//----- 文档块 ----------------------------
/**
 * 以 / ** 开头的注释是一个文档块(DocBlock)
 */

function a0() {}

//----- 文档块描述细节 --------------------

// 文档块包括哪些？
/**
 * 文档块按顺序包括3个部分
 * 1. 短描述
 * 2. 长描述
 * 3. tag段
 */

function a1() {}

//比如
/**
 * 短描述
 *
 * 这是一个长描述。
 * 继续长描述。
 * 如果短描述超过3行，则会只去第一行，作为短描述。
 *
 * 另起一段：因为上面的空行
 */

function a2() {}
// <p>的例子
/**
 * 短描述
 *
 * <p>这是一个长描述。
 * 继续长描述。
 * 用p标签包围的长描述</p>
 * <p>另起一段</p>
 * <p>再另起一段</p>
 */
function a3() {}

/**
 * phpdoc 不支持html的标签，但是可以用下面的几个标签(注意加<>)
 * 
 * b -- <b> 加粗 </b>
 *
 * br -- 换行，<br>可能被某些转换器忽略 <br>
 *
 * i -- <i> 斜体 </i>
 *
 * kbd -- <kbd> 标示 键盘输入/屏幕输出 </kbd>
 *
 * ul -- 没有顺序的列表
 *
 * li -- 列表项
 *
 * ol -- 顺序列表
 *
 * p -- 如果成对使用，则表明一个段，否则只是一个字符串<p>
 * <p>这是一个段</p>
 *
 * pre -- 
 * <pre>原样输出，即使是各种标签<b>加粗</b>，相当于XML的CDATA
 * 注意输出成HTML后，会有效果
 * </pre>
 *
 * var -- 变量名
 *
 * samp -- 非php的示例
 *
 * <code> 加粗 </code>
 *
 * 不要把这些标签想成是字符串，它们应解析器的不同，而被解析成各种形式
 * 如：b标签在DocBook中是<emphasis>，p标签在PDF中是4个空格
 * 这些都在模板的options.ini文件中定义
 *
 * 要显示带前后尖括号的b标签，可以用《《XXX》》(小写尖括号), 如<<b>>
 *
 * 要用@标签，如果行的开头，则用\@，其他地方不需要加反斜杠 \
 * 如：
 *
 * <code>
 * \@return abc
 * 这是一个标签 @name
 * </code>
 */ 

function a4() {}

/**
 * 简单的列表(不允许嵌套，因为它不再简单)
 *
 * 这是一个简单的列表(以-、+、#、o)
 * - item 1
 * - item 2, this one
 *   is multi-line
 * 这是一个简单的列表(以-、+、#、o)
 * + item 1
 * + item 2
 * 这是一个简单的列表(以-、+、#、o)
 * # item 1
 * # item 2
 * 这是一个简单的列表(以-、+、#、o)
 * o item 1
 * o item 2
 * 列表结束。下面是顺序列表(以数字开头)
 * 1 ordered item 1
 * 2 ordered item 2
 * 列表结束。下面是还是顺序列表(以数字开头，并且有个点)
 * 1. ordered item 1
 * 2. ordered item 2
 */
function a5() {}

/**
 * 有嵌套的列表
 *
 * 使用ul li ol等标签创建复杂的嵌套列表
 * <ul>
 * <li>outer item 1</li>
 * <li>outer item 2, this one
 *   is multi-line</li>
 * <li>item 3 is a nested inner list
 * <ul>
 * <li>inner item 1</li>
 * <li>inner item 2</li>
 * </ul>
 * <li>outer item 4</li>
 * </ul>
 */
function a6() {}

/**
 * 在todo标签中的列表
 * @todo My Simple TODO List
 *     - item 1
 *     - item 2
 *     - item 3
 *      - item 3
 * @todo My Complex TODO List
 *     <ol>
 *       <li>item 1.0</li>
 *       <li>item 2.0</li>
 *       <li>item 3.0</li>
 *       <li>
 *         <ol>
 *           <li>item 3.1</li>
 *           <li>item 3.2</li>
 *         </ol>
 *       <li>
 *       <li>item 4.0</li>
 *     </ol>
 */
function a7() {}

//----- Tags ------------------------------------

// Tags：以@开头的标示
// 下面是常用的Tag

/**
 * 简单的描述
 *
 * 你可以任意扩展描述，成千上万行都可以
 *
 * 用 {\@link ellement} 指向一个 element
 * 比如：指向a1: {@link a1}
 * 
 * 用 {\@link url} 指向一个站点
 * 比如：{@link http://www.sina.com.cn 新浪网}
 * 
 * 用 {\@source} 显示源代码.
 * 比如：显示函数的代码：
 * {@source } 
 * 
 * 可用Tag列表:
 * type 是PHP类型：integer, array, mixed, string等
 *
 * - @abstract
 * - @access       public or private
 * - @author       作者 <author@email>
 * - @copyright    版权
 * - @deprecated   废弃
 * - @deprec       deprecated的简写
 * - @example      指向例子
 * - @exception    兼容javadoc
 * - @global       type $globalvarname
 * - @global       type 函数中的全局变量描述
 * - @ignore
 * - @internal     给高级程序员看的内部细节描述
 * - @param        type [$varname] 描述
 * - @return       type 描述
 * - @link         URL
 * - @name         procpagealias [不懂]
 * - @name         $globalvaralias
 * - @magic        兼容phpdoc.de
 * - @package      包名
 * - @see          指向其他元素的名字，如函数名，类方法等
 * - @since        一个版本号或日期
 * - @static
 * - @staticvar    type 函数中的静态变量的描述
 * - @subpackage   子包
 * - @throws       兼容Javadoc
 * - @todo         待办列表，兼容phpdoc.de
 * - @var          type    类变量的类型
 * - @version      版本
 */
function if_there_is_an_inline_source_tag_this_must_be_a_function()
{
// ...
}


//----- 可以文档的源代码元素 ------------------------------------

//-- 包 

/*
 * Phpdoc划分包的逻辑：
 * 函数、常量、全局变量属于包
 * 方法、类变量属于类
 * 包可以包含多个类
 *
 * 一个文件中不要包含多个包
 */

//--- 程序文件级 --------------------
/*
 * 文件的第一个块就是 文件级的文档块(page-level Docblock)
 * 或者包含@package标签
 * 它可以有这些元素：
 *   标准标签
 *   @package
 *   @subpackage
 *
 */

//--- Include/Require 语句 ----------
/*
 * 它可以有这些元素：
 *   标准标签
 */ 

//--- define 语句 -------------------
/*
 * 它可以有这些元素：
 *   标准标签
 *   @name
 */ 

//--- function 声明 -------------------
/*
 * 它可以有这些元素：
 *   标准标签
 *   @global
 *   @param
 *   @return
 *   @staticvar
 *   inline {@source}
 */ 

//--- 全局变量 ------------------------
/*
 * 它可以有这些元素：
 *   标准标签
 *   @name
 */ 

//--- class 声明 -------------------
/*
 * 它可以有这些元素：
 *   标准标签
 *   @package
 *   @subpackage
 *   @static
 */ 

//--- class 变量 -------------------
/*
 * 它可以有这些元素：
 *   标准标签
 *   @var
 */ 

//--- class 变量 -------------------
/*
 * 它可以有这些元素：
 *   标准标签
 *   @global
 *   @param
 *   @return
 *   @static
 *   @staticvar
 *   inline {@source}
 */ 

/*
 * 标准文档标签
 * 常用的：
 *   @author
 *   @copyright
 *   @version
 *   @since
 *   @link
 *   @see
 * 其他：
 *   @tutorial
 *   @example
 *   @access
 *   @deprecated
 *   @ignore
 *   @internal
 *   inline {@internal}}
 *   inline {@inheritdoc}
 *   inline {@link}
 */

/*
 * 文档标签的继承关系
 *
 * Class子类可以继承父类的文档，几个简单的规则：
 *
 * @author, @version, @copyright 自动继承，除非显示指明
 * @package and @subpackage 也会继承，但是建议显示申明，以避免名字冲突
 * 如果没有简单描述，则会继承
 * 如果没有长简单描述，则会继承
 * 如果有长描述，想继承父类的描述，则使用inline标签 {@inheritdoc}
 */

//----- 命令行参数说明 ------------------------------------
// phpdoc -h 查看帮助, 参数如下：
//
/* -c --config 载入配置文件，如：-c defualt ;载入default.ini文件
 * -cp --converterparams 动态扩展转换器的参数，多个值用逗号分割
 * -ct --customtags 自定义tag，多个值用逗号分割；如：-ct mgtag,yourtag  => @mytag @yourtag
 * -d --directory 指定要解析的目录
 * -dc --defaultcategoryname 指定默认分类名，默认值为:defaul
 * -dh --hidden 相当于-dh on，让phpdoc解析以.开头的隐藏文件和目录
 * -dn --defaultpackagename 指定默认包名，默认是：default
 * -ed --examplesdir 例子文件寻找路径，如：-ed /full/path/to/example
 * -f --filename 要解析的源文件名，用,分割，可以使用 * ?
 * -i --ignore 不解析的文件名或目录，用,分割，可以使用 * ? ；
 *    - -i  忽略 /path/to/here/tests/* 和 /path/tests/*
 *    - -i *.inc 忽略所有的 .inc 文件 *
 *    - -i *path/to/* 忽略 /path/path/to/my/* 和 /path/to/*
 *    - -i *test* 忽略 /path/tests/* 和 /path/here/my_test.php
 * -is --ignoresymlinks 忽略任何链接文件，这个只在Linux/Unix下有效，因为Win下没有链接文件
 * -it --ignore-tags 忽略某些tag；通常用于创建不同版本的文档；如给普通用户的文档，就不需要@todo标签
 *    忽略inline标签，加上大括号，如--ignore-tags {@internal}
 *    参数是完整名字，如-it @todo，  -it todo 是错误的写法
 * -j --javadocdesc 使用javadoc兼容标签
 * -o --output 指定要使用的转换器和模板；默认可选：
 *   HTML:frames:* - 输出带框架的HTML页面
 *     HTML:frames:default - 类Javadoc模板，没有太多格式
 *     HTML:frames:earthli - Marco von Ballmoos写的模板，非常漂亮
 *     HTML:frames:l0l33t - 非常漂亮的模板
 *     HTML:frames:phpdoc.de - 类phpdoc.de's PHPDoc
 *     HTML:frames:phphtmllib - 非常好的用户发行模板
 *      以上模板都有javascript增强版本：HTML:frames:DOM/name 其中name表示 default, l0l33t, phpdoc.de, 等等
 *     HTML:frames:phpedit - 基于PHPEdit帮助生成器
 *
 *   HTML:Smarty:* - 输出不带框架的HTML
 *     HTML:Smarty:default - 用css控制页面布局的模板
 *     HTML:Smarty:HandS - Layout is based on PHP, but more refined, with logo image
 *     HTML:Smarty:PHP - Layout is identical to the PHP website
 *
 *   CHM:default:* - 输出成CHM格式，需要用Windows的Help软件编译
 *     CHM:default:default - 基于HTML:frames:l0l33t
 *
 *   PDF:default:* - 输出成PDF文档
 *     PDF:default:default - 标准格式
 *
 *   XML:DocBook:* - 输出成XML--DocBook格式
 *     XML:DocBook/peardoc2:default - pear.php.net（第2版）
 *
 * -p --pear Parse a PEAR-style repository (package is directory, _members are @access private) on/off default off 
 * -po --packageoutput output documentation only for selected packages. Use a comma-delimited list 
 * -pp --parseprivate 开启；默认不显示@access private的文档
 * -q --quiet 关闭多余信息；用法：-q on --不显示  -q off --显示，默认值
 * -ric --readmeinstallchangelog Specify custom filenames to parse like README, INSTALL or CHANGELOG files 
 * -s --sourcecode generate highlighted sourcecode for every parsed file (PHP 4.3.0+ only) on/off default off 
 * -t --target 要输出的路径
 * -ti --title 文档的标题
 * -tb --templatebase 指定自己的模板目录
 * -ue --undocumentedelements 为没有文档的元素 产生警告; 用法：-ue on  -ue off (默认值)
 */

/*
 * phpdoc -t /path/to/output -d path/to/directory1,/another/path,/third/path 
 *   -f /path/to/anotherfile.php -i *test.php,tests/ -pp on -ti My Title -o HTML:frames:phpedit
 *
 * phpdoc -c myconfig
 */

?>

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

• /dmd/bin/dmd
D 编译器的可执行文件

• /dmd/bin/dumpobj
Elf file dumper

• /dmd/bin/obj2asm
Elf文件反汇编器

• /dmd/bin/dmd.conf
全局配置文件(复制到 /etc/dmd.conf)

• /dmd/lib/libphobos.a
D运行库(复制到 /usr/lib/libphobos.a)

1. 下载dmd程序：http://ftp.digitalmars.com/dmd.zip，解压到~/dmd目录
2. 复制dmd.conf文件到/etc目录

cp ~/dmd/bin/dmd.conf /etc

3. 给下面的文件添加执行权限

chmod u+x ~/dmd/bin/{dmd,dumpobj,obj2asm,rdmd}

4. 把~/dmd/bin添加到PATH环境变量；或者把它们复制到/usr/local/bin目录下（不要只复制可执行程序）
5. 复制库文件到/usr/lib目录

cp ~/dmd/lib/libphobos.a /usr/lib

dmd   files...  -switches... 

Extension      File Type  
none           D source files  
.d             D source files  
.di            D interface files  
.obj           Object files to link in  
.lib           Object code libraries to search  
.exe           Name output executable file  
.def           module definition file  
.res           resource file  

Extension      File Type
none  	       D source files
.d 	           D source files
.di 	       D interface files
.o 	           Object files to link in
.a 	           Library files to link in

-debug
    编译调试代码

-debug=level
    编译调试代码：code <= level

-debug=ident
    编译调试代码：标识符为ident

-version=level
    生成版本代码：>=level

-version=ident
    生成版本代码：==ident
    
-unittest
    编译单元测试代码（还有断言）

-cov
    添加覆盖率分析指令；运行程序后，会生成.lst文件

-release
    生成发行版本；会去掉契约和断言等信息

//debug.d
import std.stdio;

void main()
{
    debug    { writefln("debug"); }
    debug(1) { writefln("debug(1)"); }
    debug(2) { writefln("debug(2)"); }

    debug(ERROR) { writefln("debug(ERROR)"); }
    debug(WARN)  { writefln("debug(WARN)"); }

    version(HOME)      { writefln("version(HOME)"); }
    version(BUSINESS)  { writefln("version(BUSINESS)"); }

    version(WINDOWS) {} else { writefln("version(!WINDOWS)"); }
}

# dmd -debug -run debug.d
debug
debug(1)
version(!WINDOWS)

# dmd -debug=1 -run debug.d
debug
debug(1)
version(!WINDOWS)

# dmd -debug=2 -run debug.d
debug
debug(1)
debug(2)
version(!WINDOWS)

# dmd -debug=ERROR -run debug.d
debug(ERROR)
version(!WINDOWS)

# dmd -debug=WARN -run debug.d
debug(WARN)
version(!WINDOWS)

# dmd -version=HOME -run debug.d
version(HOME)
version(!WINDOWS)

# dmd -version=BUSINESS -version=WINDOWS -run debug.d
version(BUSINESS)

//unittest.d
import std.stdio;

class A
{
    int i;
    this(int v) {
        i = v;
    }   

    unittest {
        A a = new A(1);
        assert(a.i == 1); 
        assert(a.i != 0); 
    }   
}

int add(int a, int b)
{
    return a - b;
    // 这里没有unittest
}

void main()
{
    // 这里没有unittest
}

unittest {
    assert(add(1, 2) == 3); 
}

# dmd -run unittest.d

# dmd -unittest -run unittest.d 
Error: AssertError Failure unittest(30)

//cov.d
import std.stdio;

void main()
{
    for (int i; i < 2; i++)
    {
        if (i < 5)
            writefln("i < 5");
        else
            writefln("i >= 5");
    }
}

# dmd -cov -run cov.d
i < 5
i < 5

       |//cov.d
       |import std.stdio;
       |
       |void main()
       |{
      6|    for (int i; i < 2; i++)
       |    {
      2|        if (i < 5)
      2|            writefln("i < 5");
       |        else
0000000|            writefln("i >= 5");
       |    }
       |}
cov.d is 75% covered

-D
    生成文档

-Dddocdir
    把文档生成到docdir目录；注意是 -Dd
	
-Dffilename
	指定文档的文件名；

dmd -D debug.d

-H
    生成.di接口文件

-Hddir
    把接口文件生成到dir目录；注意是 -Hd

-Hffilename
    指定接口文件名；注意是 -Hf

D接口文件更小，和D源文件相比处理起来更快。
可以隐藏源代码。比如以接口文件和object库的方式提供源程序，而不是提供全部源代码。

-c
    只编译，不链接；简单点说就是只生成.o文件，不生成可执行文件

-Ipath
	指定import路径；多个路径之间用分号(;)分割；允许有多个-I，并按照-I指定的路径顺序进行搜索

-Jpath
	指定D源程序中import表达式的搜索路径；多个路径之间用分号(;)分割；
	允许有多个-J，并按照-J指定的路径顺序进行搜索

-Llinkerflag
   	 把linkerflag传递给连接程序(linker)，比如: -L-L/usr/lib

-o-
    不生成.o文件，一般和-H、-D一起使用

-offilename
    指定输出文件名；可以是可执行程序，也可以是其他文件；注意是：-of

-odobjdir
    把.o文件生成到objdir目录；默认是生成到当前目录；注意是：-od

-op
	默认生成的object文件(.o)会在当前目录；添加-op参数则会生成到源文件所在目录

	dmd debug.d     # 生成debug可执行文件
	dmd -c debug.d  # 生成debug.o文件

import std.stdio;				// -I
void main()
{
    auto b = import("x.d");		// -J
}

-O
    优化生成的代码，使程序运行得更快

-g
    添加调试信息

-gc
    添加C风格的调试信息（为旧的gdb）

-inline
    用内联函数的方式进行优化；相当于C的inline

-fPIC
    生成位置无关代码

-d
    允许废弃的特征

-profile
    profile the runtime performance of the generated code 
	参见：http://www.digitalmars.com/ctg/trace.html

--help
    打印帮助

-quiet
   	安静模式，不输出无关紧要的信息

-v
    显示编译细节

-w
	显示编译警告

-run srcfile args...
    编译，链接，然后运行程序srcfile；args...(到命令行结束)都是程序的参数；
	它不会保留.o和可执行程序（No .o or executable file is left behind）

dmd 相关文件 编译开关 -run 含main的源文件 程序参数1 程序参数2

1. 当前工作目录
2. 环境变量HOME指定的目录
3. dmd命令所在目录，即bin目录
4. /etc目录

; dmd.conf 是dmd的配置文件
; 分号是注释符号
; %%包含的名字会用相应的环境变量替换
; %@P%会被本文件的路径替换，即dmd.conf文件所在路径
[Environment]
DFLAGS="-I%@P%/../src/phobos"
DDOCFILE=candydoc/proj.ddoc

• 字符串文章量是只读的；对它写会导致段错误
• 配置文件是dmd.conf，而不是sc.ini
• Windows有一个@cmdfile开关
• Windows有一个-nofloat开关
• 环境变量上有些不一样

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

1. 词法 文档注释被 附加的记号 标识..
2. 解析 文档注释 被关联到 特殊的定义和组合
3. 段落 每个文档注释 被 分解到一个段落的序列
4. 处理特定的节.
5. 非特殊的段落完成后高亮显示.
6. 合并模块中的所有段落.
7. 在最终结果执行宏文本替换.

/**
 * 这个一个Ddoc文档例子
 * 
 * Authors: Dehong Liu
 * Date:    2007年8月13日
 */

void main()
{
}

dmd -Dddoc1 a1.d			# -DdXXX 指定文档生成路径为XXX

a1

void main();
    这个一个Ddoc文档例子

    Authors:
    Dehong Liu

    Date:
    2007年8月13日 

-------------------------------------------------------------	
Page generated by Ddoc. 

 
 /** ...   */       	/ 后面两个*	
 /++ ...   +/       	/ 后面两个+
 ///					三个 /	

/// 这是一个行文档注释

/** 这也是 */

/++ 同样 +/

/**
   这是一个摘要文档
 */

/**
 * 开头的* 不是文档的一部分
 */

/*********************************
   在 /** 后面的连续的*，
   不是文档的一部分
 */

/++
   这也是一个摘要文档
 +/

/++
 + 开头的+ 不是文档的一部分
 +/

/+++++++++++++++++++++++++++++++++
   在 ／++ 后面的连续的+，
   不是文档的一部分
   上面的斜杠是中文符号，避免语法错误

   换行：注意上面的空行
 +/

/*********** 前面连续的*号不是，这部分*****是文档，后面的又不是  *****************/

module a2;

a2
这是一个行文档注释

这也是

同样



这是一个摘要文档



开头的* 不是文档的一部分



在 /** 后面的连续的*， 不是文档的一部分



这也是一个摘要文档



开头的+ 不是文档的一部分



在 ／++ 后面的连续的+， 不是文档的一部分 上面的斜杠是中文符号，避免语法错误

换行：注意上面的空行

前面连续的*号不是，这部分*****是文档，后面的又不是 

/**
 * 整个模块的文档
 */

module a3;

int a;  /// a;的文档，b没有文档
int b;

/** c和d的文档 */
/** 再添加些c和d的文档的文档 */
int c;
/** ditto */
int d;

/** e和f的文档 */ int e;
int f;	/// ditto

/** g的文档 */
int g; /// 在添加点g的文档

/// C和D的文档
class C
{
    int x;    /// C.x的文档

    /** C.y 和 C.z的文档 */
    int y;
    int z;    /// ditto
}

/// ditto
class D
{
}

int h; // 只有注释，没有文档，不会出现在html中

// 下面是空文档
int j; /// 

/// 被忽略的文档

a3
整个模块的文档

int a;
    a;的文档，b没有文档

int c;
int d;
    c和d的文档

    再添加些c和d的文档的文档

int e;
int f;
    e和f的文档

int g;
    g的文档

    在添加点g的文档

class C;
class D;
    C和D的文档

    int x;
        C.x的文档

    int y;
    int z;
        C.y 和 C.z的文档

int j;

/***********************************
 * 这是一个概要(Brief summary)
 * 描述myfunch函数的使用；这两行形成一个概要节
 *
 * 描述节的第一个段落
 *
 * 还是描述节：
 * 可以写更多内容
 */

void myfunc() { }

void myfunc();
    这是一个概要(Brief summary) 描述myfunch函数的使用；这两行形成一个概要节

    描述节的第一个段落

    还是描述节： 可以写更多内容 

• Authors: 列出作者名字
• Bugs: 列出已知BUG
• Date: 列出当前修订的时间，应当是 std.date 能解析的形式
• Deprecated: 做 "抗议"标记(？弃用标记)--最好给出理由和纠正的方法
• Examples: 例子
• History: 修订历史
• License: 版权申明
• Returns: 解释函数的返回值；如果返回void，就不要写在文档中了
• See_Also: 列出相关符号，或者URL链接
• Standards: 如果申明涉及到某个标准，在此描述
• Throws: 列出在哪些环境下会抛出异常
• Version: 指定当前申明的版本号
• See_Also: 列出相关符号，或者链接
• See_Also: 列出相关符号，或者链接

• Copyright: 版权申明。如果是在module申明中，该节会被COPYRIGHT宏替换；
• Params: 函数的参数描述文档；
"标识符 =' 开始一个新的参数描述；它可以跨越多行
• Macros: 和Params节有类似的语法；它是一系列 NAME=value 组成
NAME 是宏名，VALUE是要替换成的文字

/** Copyright: Public Domain */

module a5;

/**
 * Authors: Melvin D. Nerd, melvin@mailinator.com
 *
 * Bugs: Doesn't work for negative values.
 *
 * Date: March 14, 2003
 */

void foo1() {}

/**
 * Deprecated: superseded by function bar().
 */

deprecated void foo2() {  }

/**
 * Examples:
 * --------------------
 * writefln("3"); // writes '3' to stdout
 * --------------------
 *
 * History:
 *  V1 is initial version
 *
 *  V2 added feature X
 *
 * License: use freely for any purpose
 */

void bar() { }

/**
 * Read the file.
 * Returns: The contents of the file.
 */

void[] readFile(char[] filename) { return "filename"; }

/**
 * See_Also:
 *    foo, bar, http://www.digitalmars.com/d/phobos/index.html
 *
 * Standards: Conforms to DSPEC-1234
 *
 * Throws: WriteException on failure.
 *
 * Version: 1.6a
 */

void writeFile(char[] filename) {  }

// 特殊节

/***********************************
 * foo does this.
 * Params:
 *  x = is for this
 *      and not for that
 *  y = is for that
 */

void foo(int x, int y)
{
}

/**
 * Macros:
 *  FOO =   now is the time for
 *      all good men
 *  BAR =   bar
 *  MAGENTA =   <font color=magenta></font>
 *  COPYRIGHT = 版权归热爱地球的火星人所有
 */

/**
 * Foo: $(FOO)
 * Bar: $(BAR)
 * MAGENTA: $(MAGENTA)
 * Copyright: Public Domain 
 */
void foo3() {   }

a5

void foo1();
    Authors:
    Melvin D. Nerd, melvin@mailinator.com

    BUGS:
    Doesn't work for negative values.

    Date:
    March 14, 2003

deprecated void foo2();
    Deprecated:
    superseded by function bar().

void bar();
    Examples:

     writefln("3"); // writes '3' to stdout



    History:
    V1 is initial version

    V2 added feature X

    License:
    use freely for any purpose

void[] readFile(char[] filename);
    Read the file.

    Returns:
    The contents of the file.

void writeFile(char[] filename);
    See Also:
    foo, bar, http://www.digitalmars.com/d/phobos/index.html

    Standards:
    Conforms to DSPEC-1234

    Throws:
    WriteException on failure.

    Version:
    1.6a

void foo(int x, int y);
    foo does this.

    Params:
    int x 	is for this and not for that
    int y 	is for that

void foo3();
    Foo:
    now is the time for all good men

    Bar:
    bar

    MAGENTA:
    <font color=magenta></font>

    Copyright:
    Public Domain

Page generated by Ddoc. 版权归热爱地球的火星人所有 

* Examples:  
* --------------------  
* writefln("3"); // writes '3' to stdout  
* --------------------  

/** Example of embedded HTML:
 *   
 *      <li> <a href="http://www.digitalmars.com">Digital Mars</a> </li>
 *      <li> <a href="http://www.classicempire.com">Empire</a> </li>
 */

1. 预定义宏
2. sc.ini配置文件中的DDOCFILE项指定的文件
3. 命令行指定的*.ddoc文件
4. Ddoc运行时产生的定义，如BODY,TITLE
5. 文件中的宏节

dmd -c -Dddoc2 a5.d doc2/candydoc/*.ddoc

MODULES = 
    $(MODULE helix.basic)
    $(MODULE helix.color)
    $(MODULE helix.config)
    $(MODULE helix.linalgebra)

MODULES =
    $(MODULE a.a1)
    $(MODULE a.a2)
    $(MODULE a.a3)
    $(MODULE a.a4)
    $(MODULE a.a5)

dmd -c -Dddoc2 a1 a2 a3 a4 a5.d doc2/candydoc/*.ddoc

[Environment]
DFLAGS=-I%@P%/../src/phobos -L-L%@P%/../lib -L-L/usr/lib -L-L/usr/local/lib -version=Phobos
DDOCFILE=candy.ddoc

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

Javaeye的html编辑器用起来不爽。
不知道怎么用UBB标签的表格标签。

by: D语言论坛 http://bbs.yidabu.com/forum-10-1.html
from: http://digitalmars.com/d/dcompiler.html
version: 基于D 1.014

D语言编译器下载

最新版DMD编译器下载(Win32,Linux)
http://ftp.digitalmars.com/dmd.zip

最新版DMC下载(Win32，包含链接器和工具)
http://ftp.digitalmars.com/dmc.zip

任意版本DMD下载:
http://digitalmars.com/d/changelog.html

Win32和Linux通用的文件说明：
\dmd\src\phobos\
运行时标准库源文件

\dmd\src\dmd\
DMD编译器前端源文件

\dmd\html\d\
文档

\dmd\samples\d\
示例程序

Win32 D语言编译器

1 安装需求
1.1 32位Windows(Win32)操作系统,比如Windows XP

1.2 下载D语言编译器DMD.zip
 http://ftp.digitalmars.com/dmd.zip

1.3 下载链接器和工具DMC.zip
 http://ftp.digitalmars.com/dmc.zip

2 主要文件

\dmd\bin\dmd.exe
D语言编译器可执行文件

\dmd\bin\shell.exe
简单的命令行shell

\dmd\bin\sc.ini
D语言编译器全局设置

\dmd\lib\phobos.lib
D运行时库文件

3 安装指南

打开控制台窗口（Windows XP只要点击[开始][命令提示符])。
所有工具都是命令行工具，也就是说只能在控制台窗口里运行。
切换到你安装D的根目录，解压下载下来的文件，dmd.zip会创建\dmd目录，dmc.zip会创建\dm目录。
操作过程可能是这样：更详细的安装指南可以参考D语言论坛 http://bbs.yidabu.com/forum-10-1.html
http://bbs.yidabu.com/thread-456-1.html

 4 编译示例
\dmd\samples\d目录下有许多示例程序，进入目录
命令行执行： 

可以编译示例程序。
更详细的图文教程见这里：
http://bbs.yidabu.com/thread-457-1.html

5 编译器参数和开关节

基本的命令格式如下：files可以是： 

Extension	File Type
none	D source files
.d	D source files
.di	D interface files
.obj	Object files to link in
.lib	Object code libraries to search
.exe	Name output executable file
.def	module definition file
.res	resource file

@cmdfile
从文本文件中读入编译器参数和开关

-c
只编译不链接.

-cov
代码覆盖率分析指令

-D
从源文件中产生文档

-Dddocdir
把文档写到docdir目录

-Dffilename
把文档写到filename

-d
allow deprecated features

-debug
编译进调用代码

-debug=level
编译进<= level 的调试代码

-debug=ident
compile in debug code identified by ident

-g
add CodeView 4 symbolic debug info

-gc
add CodeView 4 symbolic debug info in C format (for C debuggers)

-H
生成D接口文件

-Hddir
把D接口文件写到dir目录

-Hffilename
把D接口文件写到filename

--help
在控制台输出帮助

-inline
inline expand functions

-Ipath
import路径。可以用;分隔。可以有多个-I。照给定路径顺序搜索。

-Jpath
Import表达式导入文件的搜索路径，其他同-Ipath
示例如：
有一个test.d主要代码如下 ：

假设temp.html的绝对路径是：D:\temp.html
进入test.d所在目录，在控制台窗口执行：
[Copy to clipboard] [ - ]
CODE:
dmd test.d -JD:\

-Llinkerflag
pass linkerflag to the linker, for example, /ma/li

-nofloat
Prevents emission of __fltused reference in object files, even if floating point code is present. Useful for library code. Windows only.( 本文出处: http://bbs.yidabu.com/forum-10-1.html )

-O
优化生成代码

-o-
不生成object文件。一般和-D,-H开关同时使用。
Suppress generation of object file. Useful in conjuction with -D or -H flags.

-odobjdir
write object files relative to directory objdir instead of to the current directory
把object文件写到当前目录的相对目录里。
比如下面命令生成object\test.obj和test.exe,test.map

dmd test.d -odobject

-offilename
设置输出文件名
比如:
[Copy to clipboard] [ - ]
CODE:
dmdtest.d -ofmy

会输出my.exe( 本文出处: http://bbs.yidabu.com/forum-10-1.html )

-op
normally the path for .d source files is stripped off when generating an object file name. -op will leave it on.
-profile
profile the runtime performance of the generated code

-quiet
关闭不必要的编译器消息

-release
编译发行版，也就是不生成契约和断言代码

-run srcfile args...
compile, link, and run the program srcfile with the rest of the command line, args..., as the arguments to the program. No .obj or .exe file is left behind.

-unittest
编译进单元测试代码(还有断言)
compile in unittest code, also turns on asserts( 本文出处: http://bbs.yidabu.com/forum-10-1.html )

-v
verbose

-version=level
compile in version code >= level

-version=ident
compile in version code identified by ident

-w
enable warnings

5 Linking链接

dmd编译器编译成功后会直接执行链接操作，不要链接就加上-c编译开关。

编译程序时必须链接D运行时库phobos.lib和C运行时库snn.lib，如果LIB环境变量设置正确，这些操作都会自动进行的。
一般这样设置：
QUOTE:
set LIB=\dmd\lib;\dm\lib

6 Environment Variables环境变量

D程序编译器dmd使用下面的环境变量：
1.1 DFLAGS

这里的值相当于dmd.exe的命令行参数
D语言论坛 http://bbs.yidabu.com/forum-10-1.html 举个简单的例子：
可以把自己写的或收集的模块放在\dmd\src\my\目录下，然后设置
QUOTE:
DFLAGS="-I%@P%\..\src\phobos;%@P%\..\src\my"

这样以后用到my下的模块时编译就省去写-I参数了

1.2 LIB

链接器搜索库文件的路径。
一般是这样的：( 本文出处: http://bbs.yidabu.com/forum-10-1.html )
QUOTE:
set LIB=\dmd\lib;\dm\lib

1.3 LINKCMD

dmd所启动的链接器的路径，你也可以指定为另外的链接器来代替：
QUOTE:
set LINKCMD=\dm\bin\link

1.4 PATH

如果dmd.exe找不到链接器，就会搜索PATH。注意：别的link.exe可能导致出错，确保在PATH搜索中首先找到Digtal Mars的link.exe，或者用LINKCMD指定链接器路径。
按：PATH设置图文教程见：http://bbs.yidabu.com/thread-457-1.html

7 sc.ini Initialization File

dmd会按照下面的目录顺序查找初始化文件sc.ini
QUOTE:
当前工作目录
HOME环境变量指定目录
dmd.exe所在目录

如果找到sc.ine，会覆盖掉任何已有设置。这样可以方便地为不同程序设置不同的环境变量。

环境变量在[Environment] 下面,形式是NAME=value键值对. NAME都大写，分号;开始行是注释

1. ; sc.ini file for dmd   
2. ; Names enclosed by %% are searched for in the existing environment   
3. ; and inserted. The special name %@P% is replaced with the path   
4. ; to this file.   
5. [Environment]   
6. LIB="%@P%\..\lib";\dm\lib   
7. DFLAGS="-I%@P%\..\src\phobos"  
8. LINKCMD="%@P%\..\..\dm\bin"  
9. DDOCFILE=mysettings.ddoc  

8 常见按照问题

Using Cygwin's unzip utility has been known to cause strange problems.
Running the compiler under Cygwin's command shell has been also known to cause problems. Try getting it to work under the regular Windows shell cmd.exe before trying Cygwin's.
dmd和dmc按装目录带空格会有问题。
General一般性说明

1 D接口文件

当处理源文件中的import声明时，编译器会搜索import对应的源文件，从中提取出需要的信息。编译器同时也会搜索D接口文件，D接口文件中只包含模块中需要导入的内容，而不是整个模块。
使用D接口文件的好处是：

D接口文件更小，和D源文件相比处理起来更快。
可以隐藏源代码。比如以接口文件和object库的方式提供源程序，而不是提供全部源代码。

D接口文件可以在编译D源文件时用-H开关创建，D接口文件的后缀是.di。当编译器分解import声明时，搜索寻找.di形式的D接口文件，再寻找D源文件。
D接口文件有点和C++头文件相似，但这不是必需的，它不属于D语言，只是编译器的一个功能，只是用来优化程序的构建。

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

build <sourcefile> [<switches> ] [<otherfiles> ]
sourcefile   一般是包括main函数的源文件
switches     上面列出的参数
otherfiles   链接库，object文件，宏定义文件等等其他文件（猜的：））

-exec         	编译成功后，运行它
-cleanup      	在编译完成后，把生成的中间文件删除掉，比如 .o 文件
-full         	编译所有的文件，即使没有修改也要编译一遍
-T<name>      	指定目标的文件名
-od<path>     	指定.o 等临时文件的输出目录

-silent      	安静模式，不输出多余信息
-test         	只是显示要调用的命令，不实际编译
-v            	build 和 dmd 都是调试模式
-V            	build 是调试模式，但dmd命令不是
-info         	显示build命令的版本号等信息
-names       	显示要编译的文件名
-uses[=fname]	输出交叉引用文件			

module a;

import b;
import std.stdio;

void main(char[][] arg)
{
    writef("in Module A: ");
    writefln(arg);
    print_b();
}

module b;

import std.stdio;

void print_b()
{
    writefln("in Module B: b.d");
}

bud a.d
bud a					# 可以不写 .d 后缀

bud a.d -exec
bud a.d -execXXX 		# 给个参数XXX
bud a.d -exec"XXX YYY" 	# 给2个参数XXX YYY  ; 在bash下不能正确运行，不知道怎么处理

bud a.d -Ta.out          # 文件名是：a.out   ;在命令行下，生成不了a.out，不知道怎么处理;(
bud a.d -Ttest_{Target}  # 文件名是：test_a

Files are up to date, no build required.

bud a.d -full

bud a.d -clean  	# -clean 是-cleanup的别名

bud a.d -names   	# 显示要编译的文件名
bud a.d -test    	# 显示dmd和gcc的调用命令
bud .ad -uses=x    	# 生成交叉引用文件，默认文件名是a.use，这里指定为x
bud a.d -v       	# 除了bud的调试信息，还显示dmd编译器的调试信息
bud a.d -V       	# 只显示bud的调试信息

[USES]
a.d <> /usr/local/src/phobos/std/stdio.d
a.d <> b.d 
b.d <> /usr/local/src/phobos/std/stdio.d
[USEDBY]
/usr/local/src/phobos/std/stdio.d <> a.d 
/usr/local/src/phobos/std/stdio.d <> b.d 
b.d <> a.d

-obj          只是创建 object文件（.o），不进行link和lib操作，等同于同时加 -nolink -nolib
-link         即使源文件中没有main()函数，也强制进行连接。
				main()函数一般在链接库中，而不在要编译的源代码中
-nolink       针对有main()函数的源文件：不进行link操作，只生成 .o 文件
-lib          针对有main()函数的源文件：不进行link操作，只生成 .a 文件
-nolib        针对没有main()函数的源文件：不进行lib操作，只生成 .o 文件
-allobj       不懂：（

-LIBOPT       指定要连接的参数
-LIBPATH      指定链接库的目录
-PP           指定除当前路径外的 其他源文件的搜索路径

#-obj：只生成.o 文件
bud a.d -obj         # 会同时生成 a.o b.o
bud b.d -obj         # 生成 b.o，不会生成 a.o ;)

#-link：强制连接
bud a.d -obj         # 生成 a.o
bud b.d a.o          # 生成 b 可执行文件

#-nolink：不链接
bud a.d -nolink      # 生成 a.o

#-lib：生成 静态库
bud a.d -lib         # 生成 a.a 为何不是liba.a?

#-nolib: 不生成 静态库
bud b.d -nolib       # 生成 b.o ，而不是 b.a

Example: Set the page size to 32Kb
    -LIBOPT-p32
Example: Embedded spaces enclosed in quotes.
    "-LIBOPT -l -i"

    -LIBPATH=c:\mylibs;d:\3rdparty;c:\lib\debuglibs
	-LIBPATH=/usr/lib:/usr/local/lib:/usr/local/lib/mysql/  

bud a.d -PP/         # 提示找不到 /b.o，因为编译的b.o生成在了当前目录，而不是根目录
bud a.d -PP/ -op     # 方案1：op是dmd的编译参数，表示在源文件的路径下生成.o文件
bud a.d -PP/ -odobj  # 方案2：把.o文件都输出到 obj 目录下

-L            		指定一个连接参数，比如：
						-L-lpthread  linux下链接libpthread.so

# 生成发行版本		# #符号是brf文件的注释符号
-T{Target}_release  # 应用程序的名字
-release            # Don't generate runtime checks.
-full               # 重新编译所有文件
-cleanup            # 编译完成后清除中间文件
-inline             # 进行内联优化

bud a @final      	# 注意@符号
bud a @final --inline	
					# 把inline选项禁用；有警告，不知道原因;(

bud @

-cleanup     		编译后清理掉.o文件  
-L-lpthread 		linux下链接libpthread.so  
-LIBPATH=c:\db 		设置库链接路径  
libdb45.lib  		直接链接windows下使用的lib文件  
-op          		.o文件输出到源文件所在路径  
-odobjs     	 	把.o文件输出到objs文件夹  
-T../bin/test 编译的可执行文件输出路径  

-cleanup  
-op  
-L-ldb  
-LIBPATH=/home/lijie/dm/lib:/home/lijie/dmd/lib:/usr/local/BerkeleyDB.4.5/lib  
src/test.d  
-T../bin/test  

-DCPATH             指定编译器的安装路径
-CFPATH             指定D配置文件的路径
-BCFPATH			指定Bud配置文件的路径

-RDF<file>			指定RDF文件（Rule Definition File）的路径
-MDF<file>			指定MDF文件（Macro Definition File）的路径

-nodef				不创建 MDF（Module Definition File）文件
-explicit			只编译指定的文件
-usefinal			

-dll 		  		如果源文件有DllMain()函数，默认会编译成Dll库；...
-gui				如果源文件有WinMain()函数，默认会编译成GUI程序；...

-help				显示帮助

-AutoWinLibs(=<Yes/No>)
-modules(=<name>)
-UMB=<Yes/No>
-R<option>
-emptyargs          

-M<name>
-X<name>

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

/**
 * iconv 转换库的学习程序
 * Edit by Liu Dehong @ 2007/08/11
 *
 * 参考了libiconv接口
 * 本程序的错误处理设计不好，只是个例子。
 * 完全没有处理常见的错误: 非法字符，内存空间
 * 因为有字符串的复制，性能消耗比较大，考虑完全用D语言改写iconv库，
 * 而不是做封装
 *
 */


/**
* 
* 
* 提供跟 GNU libiconv 库的接口
*
* Name:         libiconvD
* Purpose:      方便在D语言里实现国际编码之间的转换
*
* Author:       张雪平(heromyth)
* Email:        zxpmyth@yahoo.com.cn
* Date:         2007-6-14
* Version:      1.0.1
* Copyrights:   (c) Public Domain and BitWorld Inc.
* Licence:      BSD licence
* 
* Plan:         实现方便在D语言里直接使用的函数或者类
* 
**/

module libiconvD;

alias libiconv iconv ;  ///
alias libiconv_open iconv_open ;  ///
alias libiconv_close iconv_close ; ///


typedef void* iconv_t;

/**
* 设置要转换的编码，并为转换操作准备空间
* 
* Params:
*   fromcode = 需要被转换的源数据的编码格式
*   tocode   = 需要转换成的目标数据的编码格式
* 
* Returns:
*   (iconv_t)(-1)，如果设置有错误；<br>
*   新分配的转换描述信息器，如果设置成功。
* 
* See_Also:
*   iconv_open.3.html
* 
* 注意：
*   参数的顺序一下不能错，否则会造成后面的转换失败
*   所有支持编码可以在参考里找到
*
*/
extern (C) iconv_t libiconv_open (char *tocode, char *fromcode);


/**
* 转换核心函数
* 
* Params:
*   cd             = 转换描述信息器，由libiconv_open提供，可存放转换过程状态
*   inbuf          = 指向源字符序列的第一个位置；在执行后，指向新的空间地址：*inbuf + *inbytesleft
*   inbytesleft    = 源字符序列的字节数；在执行后，通常为0，否则为剩余未被转换的字符数
*   outbuf         = 指向存放目标字符序列的首地址；在执行后，指向新的空间地址：*outbuf + 实际转换的字节数
*   outbytesleft   = 存放目标字符序列的总的空间字节数；剩余的目标空间字节数
* 
* Returns:
*   (iconv_t)(-1) 如果转换有问题；<br>
*   0，调用过程中没有使用可逆转换；<br>
*   其它正数，在一次调用过程中以非可逆方式进行转换的字符数
* 
* 注意：
*   对各个参数含义的理解一定要正确，否则很难正确使用这个函数
*
*/
extern (C) size_t libiconv (iconv_t cd, char* * inbuf, size_t *inbytesleft, char* * outbuf, size_t *outbytesleft);


/**
* 释放先前申请的准备空间
* 
* Params:
*   cd = 指向先前由libiconv_open申请的转换描述信息器空间
*
*/
extern (C) int libiconv_close (iconv_t cd);

import std.stdio;
import std.c.string;
import std.string;
import std.c.stdlib;

char[] utf8_to_gb2312(char[] str)
{
    return code_conver("utf-8", "gb2312", str);
}

char[] gb2312_to_utf8(char[] str)
{
    return code_conver("gb2312", "utf-8", str);
}

char[] code_conver(string from, string to, in char[] in_str)
{
    auto cd = iconv_open(toStringz(to), toStringz(from));
    if (cd == cast(iconv_t)-1)
    {
        throw new Error("Can't Open from " ~ from ~ " to " ~ to);
        writefln("aaaa");
    }

	uint in_len = in_str.length;
	auto inp = toStringz(in_str);

	uint out_len = 2 * in_len;   // may be enough
	char* outp = cast(char*) malloc(out_len * char.sizeof);
    auto old_outp = outp;

    debug (1) {
    writefln("in_str.ptr: %s", in_str.ptr);
    writefln("inp: %s", inp);
    writefln("oup: %s", outp);
    }

    auto old_in_len = in_len;
    auto old_out_len = out_len;
    auto i = iconv(cd, &inp, &in_len, &outp, &out_len);
    auto conv_len = old_out_len - out_len;

	iconv_close(cd);

    debug (1) {
    writefln("i: %s", i);
    writefln("inp: %s", inp);
    writefln("oup: %s", outp);
    writefln("in_len: %s", in_len);
    writefln("out_len %s", out_len);
    }

    debug (1) {
    //printf("%s", inp);
    printf("inp: %s"\n, inp - old_in_len);
    printf("outp: %s"\n, outp - conv_len);
    }

    auto ret = toString(old_outp).dup;
    free(old_outp);

    return ret;
}

void main()
{

    try
    {
        auto str1 = utf8_to_gb2312("aabb我bb");
        printf("return: %.*s"\n, str1);

        auto str2 = gb2312_to_utf8(str1);
        printf("return: %.*s"\n, str2);
    }
    catch (Error err)
    {
        writefln("catch error: %s", err);
    }

    return ;
}

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

/**
 * expat 中的例子改写成D语言
 * Edit By Liu Dehong @ 2007/08/10
 * version: 1.0
 */

import std.stdio;
import std.stream;
import bcd.expat.xmlparse;

extern(C)
void startElement(void* userData, XML_Char* name, XML_Char** atts)
{
    int i;
    int *depthPtr = cast(int *) userData;

    for (i = 0; i < *depthPtr; i++)
        putchar('\t');

    printf("%.*s\n", name);
    *depthPtr += 1;
}

extern(C)
void endElement(void *userData, XML_Char *name)
{
    int *depthPtr = cast(int*) userData;
    *depthPtr -= 1;
}

int main()
{
    int done;
    int depth = 0;
    XML_Parser parser;

    string fn = "a.xml";
    File f = new File(fn);

    parser  = XML_ParserCreate(null);
    XML_SetUserData(parser, &depth);
    XML_SetElementHandler(parser, cast(XML_StartElementHandler)
            &startElement, cast(XML_EndElementHandler) &endElement);

    while (!f.eof())
    {
        string line = f.readLine();
        //writefln(line, line.length);

        if (!XML_Parse(parser, cast(char*) line, line.length, done)) 
        {
            fprintf(stderr,
            "%s at line %d\n",
            XML_ErrorString(XML_GetErrorCode(parser)),
            XML_GetCurrentLineNumber(parser));
            return 1;
        }
    }

    XML_ParserFree(parser);
    return 0;
}

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

/**
 * Memcached的应用程序
 * Edit by Liu Dehong @ 2007/08/09
 * Version:
 *  1.0.0
 */

import std.stdio;
import std.c.stdlib;
import std.string;
import std.socket;
import bcd.libmemcache.memcache;

void main()
{
    /* Create a new memcache instance */
    memcache *mc = mc_new();

    /* Add a few servers */
    mc_server_add(mc, "127.0.0.1", "11211");
    mc_server_add(mc, "127.0.0.1", "11212");
    mc_server_add4(mc, "127.0.0.1:11213");

    char[] key = "key";
    char[] val = "100";
    int expire = 100;
    int flags  = 0;

    /* Add a key */
    mc_add(mc, toStringz(key), key.length, toStringz(val), val.length, expire, flags);

    /* Get a key, caller has to free(3) memory */
    void *blah = mc_aget(mc, toStringz(key), key.length);
    printf("%s"\n, blah);
    auto myval = toString(cast(char*)blah).dup;
    writefln("%s", myval);
    free(blah);

    char[] key1 = "key1";
    char[] key2 = "key2";
    /* Perform a multi-key request */
    memcache_req *req = mc_req_new();
    mc_req_add(req, toStringz(key1), key1.length);
    mc_req_add(req, toStringz(key2), key2.length);
    mc_get(mc, req);
    /* Process the results (need a better interface to looping through results) */

    /* Perform a multi-key request the easy way (this is my preferred way of getting data): */
    req = mc_req_new();
    auto res1 = mc_req_add(req, toStringz(key1), key1.length);
    auto res2 = mc_req_add(req, toStringz(key2), key2.length);
    mc_get(mc, req);
    /* Play with res1/res2 w/o any looping through req */


    /* Complex multi-key get example: */
    /* Grab the response object that will be used to store a given key */
    char[] key3 = "key3";
    memcache_res *res = mc_req_add(req, toStringz(key3), key3.length);
    res.size = 1024;               /* Allocate our own memory a head of time (useful for loops) */
    res.val = malloc(res.size);
    mc_res_free_on_delete(res, 1);

    /* Perform the get */
    mc_get(mc, req);
    mc_res_free(req, res);

    /* Get stats from the whole cluster */
    memcache_server_stats *s = mc_stats(mc);
    mc_server_stats_free(s);

    /* Storage commands: */
    mc_add(mc, toStringz(key), key.length, toStringz(val), val.length, expire, flags);
    mc_replace(mc, toStringz(key), key.length, toStringz(val), val.length, expire, flags);
    //mc_replace(mc, key, key_len, val, bytes, expire, flags);
    mc_set(mc, toStringz(key), key.length, toStringz(val), val.length, expire, flags);

    int hold_timer = 0;
    /* Delete commands: */
    mc_delete(mc, toStringz(key), key.length, hold_timer);

    /* Atomic opts: */
    mc_incr(mc, toStringz(key), key.length, 10);
    mc_decr(mc, toStringz(key), key.length, 5);

    printf("%s"\n, mc_aget(mc, toStringz(key), key.length));

    mc_free(mc);
}

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

/**
 * QQWry.dat IP地址库的查找程序
 * Edit by Liu Dehong @ 2007/08/08
 * Version: 1.0.0
 *
 * 改编自 马秉尧 的PHP程序
 * QQWry.dat 来自于 CZ88.net
 * Q数据库的格式参考：http://www.pconline.com.cn/pcedu/empolder/gj/java/0505/612860.html
 */

import std.stdio;
import std.stream;
import std.string;
import std.math;

extern(C)
{
    uint ntohl(uint);
    uint inet_addr(char *cp);
    uint  htonl(uint hostlong);
    char* inet_ntoa(in_addr);
    struct in_addr
    {
        uint s_addr;
    }
}

uint ip2long(char[] ip)
{
    return ntohl(inet_addr(toStringz(ip)));
}

char[] long2ip(ulong ip)
{
    in_addr myaddr;
	myaddr.s_addr = htonl(ip);
	return toString(inet_ntoa(myaddr)).dup;
}

class IpLocation
{
    private File m_file;
    private uint m_firstip;          // 第一条IP记录的偏移地址
    private uint m_lastip;           // 最后一条IP记录的偏移地址
    private uint m_totalip;          // IP记录的总条数（不包含版本信息记录）

    static assert (int.sizeof == 4);
    static assert (uint.sizeof == 4);
    static assert (long.sizeof == 8);

    /* 从文件读取4个字节，返回整型数
     */
    uint get4Byte() 
    {
        uint i;
        m_file.read(i);
        return i;
    }
    
    /* 从文件读取3个字节的数据，返回整型数
     */
    uint get3Byte() 
    {
        ubyte c;
        uint sum;
        int[3] pow = [1, 256, 256*256];
        /**
         * 如读取的是 2 34 56 ，则结果是 2 + 34*256 + 56*256*256
         */
        for (int i; i < 3; i++)
        {
            m_file.read(c);
            sum += c * pow[i];
        }
        return sum;
    }
    
    /* 返回读取的字符串
     */
    char[] getString() 
    {
        debug(1) writefln("GetString's pos: %d(%X)", m_file.position, m_file.position);

        ubyte c;
        char[] str = new char[100]; // guess
        int i;
        for (i = 0; true; i++)
        {
            m_file.read(c);
            if (c == 0)                     // 字符串按照C格式保存，以\0结束
                break;
            if (i == str.length)
                str.length = str.length * 2;
            str[i] = c;
        }
        str.length = i;
        return str;
    }

    /* 返回地区信息
     */
    char[] getArea() 
    {
        debug(1) writefln("GetArea's pos: %d(%X)", m_file.position, m_file.position);

        ubyte flag;                         // 标志字节
        char[] area;

        m_file.read(flag);
        switch (flag) 
        {
        case 0:      
            // 没有区域信息
            area = "";
            break;

        case 1:
        case 2:                             
            // 标志字节为1或2，表示区域信息被重定向
            m_file.position(get3Byte());
            area = getString();
            break;

        default: 
            // 否则，表示区域信息没有被重定向
            area = cast(char)flag ~ getString();      // flag 是一个字符
            break;
        }
        return area;
    }
    
    /* 根据所给 IP 地址或域名返回所在地区信息
     * 索取区按照地址从小到大排列，用折半算法查找
     */
    string[string] getLocation(char[] addr) 
    {
        if ( ! m_file.readable) 
            return null;

        /* 查找纪录区的位置
         */
        uint l = 0;                         // 搜索的下边界
        uint u = m_totalip;                 // 搜索的上边界
        uint findip = m_lastip;             // 如果没有找到就返回最后一条IP记录（QQWry.Dat的版本信息）
        uint i;

        uint beginip;
        uint endip;

        auto ip_t = ip2long(addr);

        while (l <= u)                      // 当上边界小于下边界时，查找失败
        {                  
            i = std.math.lround((l + u) / 2);  
            m_file.position(m_firstip + i * 7);
            m_file.read(beginip);
            if (ip_t < beginip) 
            {
                u = i - 1; 
            }
            else 
            {
                m_file.position(get3Byte());
                m_file.read(endip);
                if (ip_t > endip) 
                {
                    l = i + 1;
                }
                else 
                {
                    findip = m_firstip + i * 7;  // find it
                    break;
                }
            }
        }
    
        debug(1) writefln("Findip is: %d(%#X)", findip, findip);

        /* 获取查找到的IP地理位置信息
         */

        string[string] location;
        m_file.position(findip);
        location["beginip"] = long2ip(get4Byte());          // 用户IP所在范围的开始地址

        auto offset = get3Byte();
        m_file.position(offset);
        location["endip"] = long2ip(get4Byte());            // 用户IP所在范围的结束地址
        
        ubyte flag1, flag2;                 // 标志字节
        m_file.read(flag1);    
        switch (flag1) 
        {
        case 1:
            // 标志字节为1，表示国家和区域信息都被同时重定向
            auto countryOffset = get3Byte();                // 重定向地址
            m_file.position(countryOffset);
            m_file.read(flag2);    // 标志字节
            switch (flag2) 
            {
            case 2:
                // 标志字节为2，表示国家信息又被重定向
                m_file.position(get3Byte());
                location["country"] = getString();
                m_file.position(countryOffset + 4);
                location["area"] = getArea();
                break;

            default:
                // 否则，表示国家信息没有被重定向
                location["country"] = cast(char)flag2 ~ getString();  // flag2 是一个字符
                location["area"] = getArea();
                break;
            }
            break;

        case 2:
            // 标志字节为2，表示国家信息被重定向
            m_file.position(get3Byte());
            location["country"] = getString();
            m_file.position(offset + 8);                    // IP地址(4B) + 定向模式(1B) + 偏移地址(3B)
            location["area"] = getArea();
            break;

        default:
            // 否则，表示国家信息没有被重定向
            location["country"] = cast(char)flag1 ~ getString();      // flag1是一个字符
            location["area"] = getArea();
            break;
        }

        debug(1) writefln("Flag1&2 : %d %d", flag1, flag2);

        if (location["country"] == " CZ88.NET")             // CZ88.NET表示没有有效信息
        {
            location["country"] = "unkown";
        }
        if (location["area"] == " CZ88.NET") 
        {
            location["area"] = "";
        }
        return location;
    }
    
    /**
     * 构造函数，打开 QQWry.Dat 文件并初始化类中的信息
     */
    this(char[] filename = "QQWry.Dat") 
    {
        m_file      = new File(filename);
        m_firstip   = get4Byte();
        m_lastip    = get4Byte();
        m_totalip   = (m_lastip - m_firstip) / 7;
    }

    uint firstip()
    {
        return m_firstip;
    }
    uint lastip()
    {
        return m_lastip;
    }
    uint totalip()
    {
        return m_totalip;
    }
}

void main()
{

    auto ipObj = new IpLocation;

    writefln("First IP is: %s", ipObj.firstip);
    writefln("Last IP is : %s", ipObj.lastip);
    writefln("Total ip is: %s", ipObj.totalip);
    
    string[] myips = [
        "0.255.255.255",
        "0.255.255.255",
        "1.255.255.255",
        "4.10.255.255",
        "4.10.255.255",
        "4.19.77.255",
        "59.57.7.206",
        "222.79.141.30",
        "211.100.32.245",
        "202.106.184.145",
        "202.205.82.122",
        "0.1.163.136",
    ];

    string[string] loc;
    foreach (int k, string v; myips)
    {
        loc = ipObj.getLocation(v);
        printf("%*s in [%.*s ~ %.*s]"\n, v, loc["beginip"], loc["endip"]);
        printf("Country: %-20.*s Area: %-20.*s"\n, loc["country"], loc["area"]);
    }
}

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

import std.stdio;
import std.string;

extern(C)
{
    uint ntohl(uint);
    uint inet_addr(char *cp);
    uint  htonl(uint hostlong);
    char* inet_ntoa(in_addr);
    struct in_addr
    {
        uint s_addr;
    }
}

ulong ip2long(char[] ip)
{
    return ntohl(inet_addr(toStringz(ip)));
}

char[] long2ip(ulong ip)
{
    in_addr myaddr;
	myaddr.s_addr = htonl(ip);
	return toString(inet_ntoa(myaddr));
}

void main()
{
    char* c_str1;
    char* c_str2;
    char* c_str3;
    char[] d_str1;
    char[] d_str2;
    char[] d_str3;

    c_str1 = "C string";
    d_str1 = "D string";

    // C字符串 转换到 D字符串
    d_str2 = toString(c_str1);

    writefln("c to d: %s", d_str2);
    printf("c to d: %.*s"\n, d_str2);

    // D字符串 转换到 C字符串
    c_str2 = cast(char*) (d_str1 ~ "\0");
    c_str3 = toStringz(d_str1);

    printf("d to c: %s"\n, c_str2);
    printf("d to c: %s"\n, c_str3);
    
    // cast(char*)转换和直接str.ptr是一样的，不保证有\0结尾，除非运气好刚好碰上一个。
    //c_str2 = cast(char*) (d_str1); //error
    //printf("%s"\n, d_str1.ptr);   // error

    writefln(ip2long("192.0.34.166"));
    writefln(long2ip(3221234342));
}

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

// This code is derived from the
// RSA Data Security, Inc. MD5 Message-Digest Algorithm.

import std.md5;

private import std.stdio;
private import std.string;
private import std.c.stdio;
private import std.c.string;

int main(char[][] args)
{
    foreach (char[] arg; args)
     MDFile(arg);

    MDString("Hello, D");

    return 0;
}

/* Digests a file and prints the result. */
void MDFile(char[] filename)
{
    FILE* file;
    MD5_CTX context;
    int len;
    //ubyte[4 * 1024] buffer;
    ubyte[] buffer;
    buffer.length = 4 * 1024;
    ubyte digest[16];

    if ((file = fopen(std.string.toStringz(filename), "rb")) == null)
    {
        writefln("%s can't be opened", filename);
    }
    else
    {
        context.start();
        while ((len = fread(cast(void*) buffer, 1, buffer.sizeof, file)) != 0)
            context.update(buffer[0 .. len]);
        context.finish(digest);
        fclose(file);

        writefln("MD5 File (%s) = %s", filename, digestToString(digest));
    }
}

/* Digest a string and prints the result. */
void MDString(char[] str)
{
    MD5_CTX context;
    ubyte digest[16];

    if (str.length)
    {
        context.start();
        context.update(str);
        context.finish(digest);

        if (str.length > 10)
            writefln("MD5 String (%s..) = %s", str[0..10], digestToString(digest));
        else
            writefln("MD5 String (%s) = %s", str, digestToString(digest));
    }
}

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

import std.stdio;
import std.string;
import std.c.string;

class A
{
}

void main()
{
    char[] str;

    str = "abcde";

    str ~= "\0";
    printf("string(%d) '%s'\n", strlen(cast(char*)str), cast(char*)str);
    writefln("string(%d) :%s", str.length, str);

    str = "edcba";
    printf("string(%d) '%s'\n", strlen(cast(char*)str), toStringz(str));
    writefln("string(%d) :%s", str.length, str);
    writefln("%s", str);

    // 区别
    printf("the string is '%.*s'\n", "aaaaaaaaaaaaa我");
    printf("the string is '%*s'\n", "aaaaaaaaaaaaa我");

    int a = 456;
    printf("d: %d %05d %+d |%-5d| |%5d| |% d| |% d|"\n, a, a, a, a, a, a, -a);        // 十进制
    writef("d: %d %05d %+d |%-5d| |%5d| |% d| |% d|"\n, a, a, a, a, a, a, -a);        // 十进制
    printf("*: |%*d| |%-*d| |%.*d| |%*.d|"\n, 5, a, 5, a, 5, a, 5, a);
    writef("*: |%*d| |%-*d| |%.*d| |%*.d|"\n, 5, a, 5, a, 5, a, 5, a);

    printf("u: %u %05u %+u |%-5u| |%5u|"\n, a, a, a, a, a);        // 十进制无符号
    //writef("u: %u %05u %+u |%-5u| |%5u|"\n, a, a, a, a, a);        // 十进制无符号
    //
    printf("o:  %o %#o"\n, a, a);        // 八进制
    writef("o:  %o %#o"\n, a, a);        // 八进制

    printf("x: %X %x %#x %#X %05x |%-5x|"\n, a, a, a, a, a, a);        // 十六进制
    writef("x: %X %x %#x %#X %05x |%-5x|"\n, a, a, a, a, a, a);        // 十六进制

    float f = 2.1, f2 = 2222222, f3 = 0.1111111111;
    printf("f: %f |%.3f| |%5f| |%3.5f| |%5.3f|"\n, f, f2, f3, f, f);        // 浮点数
    writef("f: %f |%.3f| |%5f| |%3.5f| |%5.3f|"\n, f, f2, f3, f, f);        // 浮点数

    float e = 2.1, e2 = 2222222, e3 = 0.1111111111;
    printf("e: %e |%.3e| |%5e| |%3.5e| |%5.3e|"\n, e, e2, e3, e, e);        // 指数
    writef("e: %e |%.3e| |%5e| |%3.5e| |%5.3e|"\n, e, e2, e3, e, e);        // 指数

    printf("g: %g |%.3g| |%5g| |%3.5g| |%5.3g|"\n, e, e2, e3, e, e);        // 十六进制
    writef("g: %g |%.3g| |%5g| |%3.5g| |%5.3g|"\n, e, e2, e3, e, e);        // 十六进制

    printf("a: %a |%.3a| |%5a| |%3.5a| |%5.3a|"\n, e, e2, e3, e, e);        // 不懂
    writef("a: %a |%.3a| |%5a| |%3.5a| |%5.3a|"\n, e, e2, e3, e, e);        // 不懂

    // * 号作为宽度标志和精度标志
    printf("*: |%*f| |%-*f| |%.*f| |%*.f| |%*.*f|"\n, 5, e, 5, e, 5, e, 5, e, 8, 3, e);
    writef("*: |%*f| |%-*f| |%.*f| |%*.f| |%*.*f|"\n, 5, e, 5, e, 5, e, 5, e, 8, 3, e);

    A aa = new A;
    int[] ab = [1, 2, 3];
    writef("s: %s %s %s %s %s %s", true, -10, -2.0001, "abc", aa, ab);

}

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师

import std.stdio;
import std.base64;

void main()
{
    char[] a;
    char[] b;
    char[] c;

    // 方法1
    a = "%%%abdsfds%";
    a = "张33";
    writefln("a string (%d):\t%s", a.length, a);

    b = encode(a);
    writefln("b string (%d):\t%s", b.length, b);

    c = decode(b);
    writefln("c string (%d):\t%s", c.length, c);

    assert(c == a);

    writefln();

    // 方法2

    char[] d;
    char[] e = new char[100];
    char[] f = new char[100];
    e[] = 0;
    f[] = 0;

    d = "%%%ABCCCC%AFDSFDS%";
    d = "CCCCAAFDSFDSAAAAAA";
    d = "张33";

    writefln("d string (%d):\t%s", d.length, d);

    encode(d, e);
    e.length = encodeLength(d.length);
    writefln("e string (%d):\t%s", e.length, e);

    decode(e, f);
    f.length = decodeLength(e.length);
    writefln("f string (%d):\t%s", f.length, f);

    assert(d == f);
}

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师