由于客户需求的变化,近日的工作重点不得不发生比较大的改变。
这两天折腾spider, 被编码问题搞了半天。
小记一下:
Vbptr是做什么用的呢?看下面
该变量指向一个全类共享的偏移量表
附:转一篇文章
——谈VC++对象模型 译者前言 一
个C++程序员,想要进一步提升技术水平的话,应该多了解一些语言的语意细节。对于使用VC++的程序员来说,还应该了解一些VC++对于C++的诠释。
Inside the C++ Object
Model虽然是一本好书,然而,书的篇幅多一些,又和具体的VC++关系小一些。因此,从篇幅和内容来看,译者认为本文是深入理解C++对象模型比较好
的一个出发点。 本文原文出处为MSDN。如果你安装了MSDN,可以搜索到C++ Under the Hood。否则也可在网站上找到 http://msdn.microsoft.com/archive/default.asp?url=/archive/en-us/dnarvc/html/jangrayhood.asp 。 1 前言 了 解你所使用的编程语言究竟是如何实现的,对于C++程序员可能特别有意义。首先,它可以去除我们对于所使用语言的神秘感,使我们不至于对于编译器干的活感 到完全不可思议;尤其重要的是,它使我们在Debug和使用语言高级特性的时候,有更多的把握。当需要提高代码效率的时候,这些知识也能够很好地帮助我 们。 本文着重回答这样一些问题: 对 每个语言特性,我们将简要介绍该特性背后的动机,该特性自身的语意(当然,本文决不是“C++入门”,大家对此要有充分认识),以及该特性在微软的 VC++中是如何实现的。这里要注意区分抽象的C++语言语意与其特定实现。微软之外的其他C++厂商可能提供一个完全不同的实现,我们偶尔也会将 VC++的实现与其他实现进行比较。 2 类布局 本节讨论不同的继承方式造成的不同内存布局。 2.1 C结构(struct) 由 于C++基于C,所以C++也“基本上”兼容C。特别地,C++规范在“结构”上使用了和C相同的,简单的内存布局原则:成员变量按其被声明的顺序排列, 按具体实现所规定的对齐原则在内存地址上对齐。所有的C/C++厂商都保证他们的C/C++编译器对于有效的C结构采用完全相同的布局。这里,A是一个简 单的C结构,其成员布局和对齐方式都一目了然
struct A { 译者注:从上图可见,A在内存中占有8个字节,按照声明成员的顺序,前4个字节包含一个字符(实际占用1个字节,3个字节空着,补对齐),后4个字节包含一个整数。A的指针就指向字符开始字节处。 2.2 有C++特征的C结构 当 然了,C++不是复杂的C,C++本质上是面向对象的语言:包含继承、封装,以及多态。原始的C结构经过改造,成了面向对象世界的基石——类。除了成员变 量外,C++类还可以封装成员函数和其他东西。然而,有趣的是,除非为了实现虚函数和虚继承引入的隐藏成员变量外,C++类实例的大小完全取决于一个类及 其基类的成员变量!成员函数基本上不影响类实例的大小。 这里提供的B是一个C结构,然而,该结构有一些C++特 征:控制成员可见性的“public/protected/private”关键字、成员函数、静态成员,以及嵌套的类型声明。虽然看着琳琅满目,实际上 只有成员变量才占用类实例的空间。要注意的是,C++标准委员会不限制由“public/protected/private”关键字分开的各段在实现时 的先后顺序,因此,不同的编译器实现的内存布局可能并不相同。(在VC++中,成员变量总是按照声明时的顺序排列)。
struct B { 译者注:B中,为何static int bsm不占用内存空间?因为它是静态成员,该数据存放在程序的数据段中,不在类实例中。 2.3 单继承 C++
提供继承的目的是在不同的类型之间提取共性。比如,科学家对物种进行分类,从而有种、属、纲等说法。有了这种层次结构,我们才可能将某些具备特定性质的东
西归入到最合适的分类层次上,如“怀孩子的是哺乳动物”。由于这些属性可以被子类继承,所以,我们只要知道“鲸鱼、人”是哺乳动物,就可以方便地指出“鲸
鱼、人都可以怀孩子”。那些特例,如鸭嘴兽(生蛋的哺乳动物),则要求我们对缺省的属性或行为进行覆盖。
struct C {
struct D : C { 既然派生类要保留基类的所有属性和行为,自然地,每个派生类的实例都包含了一份完整的基类实例数据。在D中,并不是说基类C的数据一定要放在D的数据之前,只不过这样放的话,能够保证D中的C对象地址,恰好是D对象地址的第一个字节。这种安排之下,有了派生类D的指针,要获得基类C的指针,就不必要计算偏移量了。几乎所有知名的C++厂商都采用这种内存安排(基类成员在前)。在单继承类层次下,每一个新的派生类都简单地把自己的成员变量添加到基类的成员变量之后。看看上图,C对象指针和D对象指针指向同一地址。 2.4 多重继承 大多数情况下,其实单继承就足够了。但是,C++为了我们的方便,还提供了多重继承。 比 如,我们有一个组织模型,其中有经理类(分任务),工人类(干活)。那么,对于一线经理类,即既要从上级经理那里领取任务干活,又要向下级工人分任务的角 色来说,如何在类层次中表达呢?单继承在此就有点力不胜任。我们可以安排经理类先继承工人类,一线经理类再继承经理类,但这种层次结构错误地让经理类继承 了工人类的属性和行为。反之亦然。当然,一线经理类也可以仅仅从一个类(经理类或工人类)继承,或者一个都不继承,重新声明一个或两个接口,但这样的实现 弊处太多:多态不可能了;未能重用现有的接口;最严重的是,当接口变化时,必须多处维护。最合理的情况似乎是一线经理从两个地方继承属性和行为——经理 类、工人类。 C++就允许用多重继承来解决这样的问题: struct Manager ... { ... }; 这样的继承将造成怎样的类布局呢?下面我们还是用“字母类”来举例:
struct E {
struct F : C, E { 观察类布局,可以看到F中内嵌的E对象,其指针与F指针并不相同。正如后文讨论强制转化和成员函数时指出的,这个偏移量会造成少量的调用开销。 具体的编译器实现可以自由地选择内嵌基类和派生类的布局。VC++按照基类的声明顺序先排列基类实例数据,最后才排列派生类数据。当然,派生类数据本身也是按照声明顺序布局的(本规则并非一成不变,我们会看到,当一些基类有虚函数而另一些基类没有时,内存布局并非如此)。 2.5 虚继承 回到我们讨论的一线经理类例子。让我们考虑这种情况:如果经理类和工人类都继承自“雇员类”,将会发生什么? 很不幸,在C++中,这种“共享继承”被称为“虚继承”,把问题搞得似乎很抽象。虚继承的语法很简单,在指定基类时加上virtual关键字即可。 struct G : virtual C { struct H : virtual C { 在VC++中,对每个继承自虚基类的类实例,将增加一个隐藏的“虚基类表指针”(vbptr)成员变量,从而达到间接计算虚基类位置的目的。该变量指向一个全类共享的偏移量表,表中项目记录了对于该类而言,“虚基类表指针”与虚基类之间的偏移量。 其 它的实现方式中,有一种是在派生类中使用指针成员变量。这些指针成员变量指向派生类的虚基类,每个虚基类一个指针。这种方式的优点是:获取虚基类地址时, 所用代码比较少。然而,编译器优化代码时通常都可以采取措施避免重复计算虚基类地址。况且,这种实现方式还有一个大弊端:从多个虚基类派生时,类实例将占 用更多的内存空间;获取虚基类的虚基类的地址时,需要多次使用指针,从而效率较低等等。 在VC++中,G拥有一 个隐藏的“虚基类表指针”成员,指向一个虚基类表,该表的第二项是GdGvbptrC。(在G中,虚基类对象C的地址与G的“虚基类表指针”之间的偏移量 (当对于所有的派生类来说偏移量不变时,省略“d”前的前缀))。比如,在32位平台上,GdGvptrC是8个字节。同样,在I实例中的G对象实例也有 “虚基类表指针”,不过该指针指向一个适用于“G处于I之中”的虚基类表,表中一项为IdGvbptrC,值为20。 观察前面的G、H和I,我们可以得到如下关于VC++虚继承下内存布局的结论: 该布局安排使得虚基类的位置随着派生类的不同而“浮动不定”,但是,非虚基类因此也就凑在一起,彼此的偏移量固定不变。 3 成员变量 介绍了类布局之后,我们接着考虑对不同的继承方式,访问成员变量的开销究竟如何。 没有继承。没有任何继承关系时,访问成员变量和C语言的情况完全一样:从指向对象的指针,考虑一定的偏移量即可。 单继承。由于派生类实例与其基类实例之间的偏移量是常数0,所以,可以直接利用基类指针和基类成员之间的偏移量关系,如此计算得以简化。 多重继承。虽然派生类与某个基类之间的偏移量可能不为0,然而,该偏移量总是一个常数。只要是个常数,访问成员变量,计算成员变量偏移时的计算就可以被简化。可见即使对于多重继承来说,访问成员变量开销仍然不大。 虚继承。当类有虚基类时,访问非虚基类的成员仍然是计算固定偏移量的问题。然而,访问虚基类的成员变量,开销就增大了, 因为必须经过如下步骤才能获得成员变量的地址:获取“虚基类表指针”;获取虚基类表中某一表项的内容;把内容中指出的偏移量加到“虚基类表指针”的地址 上。然而,事情并非永远如此。正如下面访问I对象的c1成员那样,如果不是通过指针访问,而是直接通过对象实例,则派生类的布局可以在编译期间静态获得, 偏移量也可以在编译时计算,因此也就不必要根据虚基类表的表项来间接计算了。 I* pi; 当 访问类继承层次中,多层虚基类的成员变量时,情况又如何呢?比如,访问虚基类的虚基类的成员变量时?一些实现方式为:保存一个指向直接虚基类的指针,然后 就可以从直接虚基类找到它的虚基类,逐级上推。VC++优化了这个过程。VC++在虚基类表中增加了一些额外的项,这些项保存了从派生类到其各层虚基类的 偏移量。 4 强制转化 如果没有虚基类的问题,将一个指针强制转化为另一个类型的指针代价并不高昂。如果在要求转化的两个指针之间有“基类-派生类”关系,编译器只需要简单地在两者之间加上或者减去一个偏移量即可(并且该量还往往为0)。 F* pf; C 和E是F的基类,将F的指针pf转化为C*或E*,只需要将pf加上一个相应的偏移量。转化为C类型指针C*时,不需要计算,因为F和C之间的偏移量为 0。转化为E类型指针E*时,必须在指针上加一个非0的偏移常量dFE。C++规范要求NULL指针在强制转化后依然为NULL,因此在做强制转化需要的 运算之前,VC++会检查指针是否为NULL。当然,这个检查只有当指针被显示或者隐式转化为相关类型指针时才进行;当在派生类对象中调用基类的方法,从 而派生类指针被在后台转化为一个基类的Const “this” 指针时,这个检查就不需要进行了,因为在此时,该指针一定不为NULL。 正如你猜想的,当继承关系中存在虚基类时,强制转化的开销会比较大。具体说来,和访问虚基类成员变量的开销相当。 I* pi; 一般说来,当从派生类中访问虚基类成员时,应该先强制转化派生类指针为虚基类指针,然后一直使用虚基类指针来访问虚基类成员变量。这样做,可以避免每次都要计算虚基类地址的开销。见下例。 /* before: */ ... pi->c1 ... pi->c1 ... 5 成员函数 一
个C++成员函数只是类范围内的又一个成员。X类每一个非静态的成员函数都会接受一个特殊的隐藏参数——this指针,类型为X*
const。该指针在后台初始化为指向成员函数工作于其上的对象。同样,在成员函数体内,成员变量的访问是通过在后台计算与this指针的偏移来进行。 P
有一个非虚成员函数pf(),以及一个虚成员函数pvf()。很明显,虚成员函数造成对象实例占用更多内存空间,因为虚成员函数需要虚函数表指针。这一点
以后还会谈到。这里要特别指出的是,声明非虚成员函数不会造成任何对象实例的内存开销。现在,考虑P::pf()的定义。 这
里P:pf()接受了一个隐藏的this指针参数,对于每个成员函数调用,编译器都会自动加上这个参数。同时,注意成员变量访问也许比看起来要代价高昂一
些,因为成员变量访问通过this指针进行,在有的继承层次下,this指针需要调整,所以访问的开销可能会比较大。然而,从另一方面来说,编译器通常会
把this指针缓存到寄存器中,所以,成员变量访问的代价不会比访问局部变量的效率更差。 5.1 覆盖成员函数 和 成员变量一样,成员函数也会被继承。与成员变量不同的是,通过在派生类中重新定义基类函数,一个派生类可以覆盖,或者说替换掉基类的函数定义。覆盖是静态 (根据成员函数的静态类型在编译时决定)还是动态(通过对象指针在运行时动态决定),依赖于成员函数是否被声明为“虚函数”。 Q从P继承了成员变量和成员函数。Q声明了pf(),覆盖了P::pf()。Q还声明了pvf(),覆盖了P::pvf()虚函数。Q还声明了新的非虚成员函数qf(),以及新的虚成员函数qvf()。 struct Q : P { 对于虚函数调用来说,调用哪个成员函数在运行时决定。不管“->”操作符左边的指针表达式的类型如何,调用的虚函数都是由指针实际指向的实例类型所决定。比如,尽管ppq的类型是P*,当ppq指向Q的实例时,调用的仍然是Q::pvf()。 为了实现这种机制,引入了隐藏的vfptr成员变量。一个vfptr被加入到类中(如果类中没有的话),该vfptr指向类的虚函数表(vftable)。类中每个虚函数在该类的虚函数表中都占据一项。每项保存一个对于该类适用的虚函数的地址。因此,调用虚函数的过程如下:取得实例的vfptr;通过vfptr得到虚函数表的一项;通过虚函数表该项的函数地址间接调用虚函数。也就是说,在普通函数调用的参数传递、调用、返回指令开销外,虚函数调用还需要额外的开销。 回头再看看P和Q的内存布局,可以发现,VC++编译器把隐藏的vfptr成员变量放在P和Q实例的开始处。这就使虚函数的调用能够尽量快一些。实际上,VC++的实现方式是,保证任何有虚函数的类的第一项永远是vfptr。这就可能要求在实例布局时,在基类前插入新的vfptr,或者要求在多重继承时,虽然在右边,然而有vfptr的基类放到左边没有vfptr的基类的前面(如下)。 class CA { int a;}; class CB { int b;}; class CL : public CB, public CA { int c;}; 以上的类继承, 对CL类说, 他的内存布局是 int b; int a; int c; 但是, 改造CA如下: class CA { int a; virtual void seta( int _a ) { a = _a; } }; 同样继承顺序的CL, 内存中布局是 vfptr int a; int b; int c; CA被提到CB前面, 这样的布局是因为 class 的布局就是 vfptr肯定要放在最前面. 许多C++的实现会共享或者重用从基类继承来的vfptr。比如,Q并不会有一个额外的vfptr,指向一个专门存放新的虚函数qvf()的虚函数表。 Qvf项只是简单地追加到P的虚函数表的末尾。如此一来,单继承的代价就不算高昂。一旦一个实例有vfptr了,它就不需要更多的vfptr。新的派生类 可以引入更多的虚函数,这些新的虚函数只是简单地在已存在的,“每类一个”的虚函数表的末尾追加新项。 5.2 多重继承下的虚函数 如果从多个有虚函数的基类继承,一个实例就有可能包含多个vfptr。考虑如下的R和S类: struct S : P, R { 这
里R是另一个包含虚函数的类。因为S从P和R多重继承,S的实例内嵌P和R的实例,以及S自身的数据成员S::s1。注意,在多重继承下,靠右的基类R,
其实例的地址和P与S不同。S::pvf覆盖了P::pvf()和R::pvf(),S::rvf()覆盖了R::rvf()。 因
为S::pvf()覆盖了P::pvf()和R::pvf(),在S的虚函数表中,相应的项也应该被覆盖。然而,我们很快注意到,不光可以用P*,还可以
用R*来调用pvf()。问题出现了:R的地址与P和S的地址不同。表达式(R*)ps与表达式(P*)ps指向类布局中不同的位置。因为函数
S::pvf希望获得一个S*作为隐藏的this指针参数,虚函数必须把R*转化为S*。因此,在S对R虚函数表的拷贝中,pvf函数对应的项,指向的是
一个“调整块”的地址,该调整块使用必要的计算,把R*转换为需要的S*。 在微软VC++实现中,对于有虚函数的多重继承,只有当派生类虚函数覆盖了多个基类的虚函数时,才使用调整块。 5.3 地址点与“逻辑this调整” 考虑下一个虚函数S::rvf(),该函数覆盖了R::rvf()。我们都知道S::rvf()必须有一个隐藏的S*类型的this参数。但是,因为也可以用R*来调用rvf(),也就是说,R的rvf虚函数槽可能以如下方式被用到: 当然,在debugger中,必须对这种this调整进行补偿。 所以,当覆盖非最左边的基类的虚函数时,MSC++一般不创建调整块,也不增加额外的虚函数项。 5.4 调整块 正 如已经描述的,有时需要调整块来调整this指针的值(this指针通常位于栈上返回地址之下,或者在寄存器中),在this指针上加或减去一个常量偏 移,再调用虚函数。某些实现(尤其是基于cfront的)并不使用调整块机制。它们在每个虚函数表项中增加额外的偏移数据。每当虚函数被调用时,该偏移数 据(通常为0),被加到对象的地址上,然后对象的地址再作为this指针传入。 ps->rvf(); 这种方法的缺点是虚函数表增大了,虚函数的调用也更加复杂。 现代基于PC的实现一般采用“调整—跳转”技术: 5.5 虚继承下的虚函数 T
虚继承P,覆盖P的虚成员函数,声明了新的虚函数。如果采用在基类虚函数表末尾添加新项的方式,则访问虚函数总要求访问虚基类。在VC++中,为了避免获
取虚函数表时,转换到虚基类P的高昂代价,T中的新虚函数通过一个新的虚函数表获取,从而带来了一个新的虚函数表指针。该指针放在T实例的顶端。 在此U增加了一个成员变量,从而改变了P的偏移。因为VC++实现中,T::pvf()接受的是嵌套在T中的P的指针,所以,需要提供一个调整块,把this指针调整到T::t1之后(该处即是P在T中的位置)。 5.6 特殊成员函数 本节讨论编译器合成到特殊成员函数中的隐藏代码。 5.6.1 构造函数和析构函数 正如我们所见,在构造和析构过程中,有时需要初始化一些隐藏的成员变量。最坏的情况下,一个构造函数要执行如下操作: * 如果是“最终派生类”,初始化vbptr成员变量,调用虚基类的构造函数; (注意:一个“最终派生类”的实例,一定不是嵌套在其他派生类实例中的基类实例) 所以,如果你有一个包含虚函数的很深的继承层次,即使该继承层次由单继承构成,对象的构造可能也需要很多针对虚函数表的初始化。 * 合成并初始化虚函数表成员变量 在 VC++中,有虚基类的类的构造函数接受一个隐藏的“最终派生类标志”,标示虚基类是否需要初始化。对于析构函数,VC++采用“分层析构模型”,代码中 加入一个隐藏的析构函数,该函数被用于析构包含虚基类的类(对于“最终派生类”实例而言);代码中再加入另一个析构函数,析构不包含虚基类的类。前一个析 构函数调用后一个。 5.6.2 虚析构函数与delete操作符 假如A是B的父类, 实际上,很多人这样总结:当且仅当类里包含至少一个虚函数的时候才去声明虚析构函数。 考虑结构V和W。 为 了实现上述语意,VC++扩展了其“分层析构模型”,从而自动创建另一个隐藏的析构帮助函数——“deleting析构函数”,然后,用该函数的地址来替 换虚函数表中“实际”虚析构函数的地址。析构帮助函数调用对该类合适的析构函数,然后为该类有选择性地调用合适的delete操作符。 6 数组 堆上分配空间的数组使虚析构函数进一步复杂化。问题变复杂的原因有两个: 虽 然从严格意义上来说,数组delete的多态行为C++标准并未定义,然而,微软有一些客户要求实现该行为。因此,在MSC++中,该行为是用另一个编译 器生成的虚析构帮助函数来完成。该函数被称为“向量delete析构函数”(因其针对特定的类定制,比如WW,所以,它能够遍历数组的每个元素,调用对每 个元素适用的析构函数)。 7 异常处理 简单说来,异常处理是C++标准委员会工作文件提供的一种机制,通过该机制,一个函数可以通知其调用者“异常”情况的发生,调用者则能据此选择合适的代码来处理异常。该机制在传统的“函数调用返回,检查错误状态代码”方法之外,给程序提供了另一种处理错误的手段。 因
为C++是面向对象的语言,很自然地,C++中用对象来表达异常状态。并且,使用何种异常处理也是基于“抛出的”异常对象的静态或动态类型来决定的。不光
如此,既然C++总是保证超出范围的对象能够被正确地销毁,异常实现也必须保证当控制从异常抛出点转换到异常“捕获”点时(栈展开),超出范围的对象能够
被自动、正确地销毁。 int main() { void f(int i) { void g(int j) { 这 段程序会抛出异常。在main中,加入了处理异常的try & catch框架,当调用f(0)时,f构造z1,调用g(0)后,再构造z2,再调用g(-1),此时g发现参数为负,抛出X异常对象。我们希望在某个调 用层次上,该异常能够得到处理。既然g和f都没有建立处理异常的框架,我们就只能希望main函数建立的异常处理框架能够处理X异常对象。实际上,确实如 此。当控制被转移到main中异常捕获点时,从g中的异常抛出点到main中的异常捕获点之间,该范围内的对象都必须被销毁。在本例中,z2和z1应该被 销毁。 谈到异常处理的具体实现方式,一般情况下,在抛出点和捕获点都使用“表”来表述能够捕获异常对象的类型; 并且,实现要保证能够在特定的捕获点真正捕获特定的异常对象;一般地,还要运用抛出的对象来初始化捕获语句的“实参”。通过合理地选择编码方案,可以保证 这些表格不会占用过多的内存空间。 异常处理的开销到底如何?让我们再考虑一下函数f。看起来f没有做异常处理。 f确实没有包含try,catch,或者是throw关键字,因此,我们会猜异常处理应该对f没有什么影响。错!编译器必须保证一旦z1被构造,而后续调 用的任何函数向f抛回了异常,异常又出了f的范围时,z1对象能被正确地销毁。同样,一旦z2被构造,编译器也必须保证后续抛出异常时,能够正确地销毁 z2和z1。 要实现这些“展开”语意,编译器必须在后台提供一种机制,该机制在调用者函数中,针对调用的函数抛 出的异常动态决定异常环境(处理点)。这可能包括在每个函数的准备工作和善后工作中增加额外的代码,在最糟糕的情况下,要针对每一套对象初始化的情况更新 状态变量。例如,上述例子中,z1应被销毁的异常环境当然与z2和z1都应该被销毁的异常环境不同,因此,不管是在构造z1后,还是继而在构造z2 后,VC++都要分别在状态变量中更新(存储)新的值。 所有这些表,函数调用的准备和善后工作,状态变量的更新,都会使异常处理功能造成可观的内存空间和运行速度开销。正如我们所见,即使在没有使用异常处理的函数中,该开销也会发生。 幸运的是,一些编译器可以提供编译选项,关闭异常处理机制。那些不需要异常处理机制的代码,就可以避免这些额外的开销了。 8 小结 好了,现在你可以写C++编译器了(开个玩笑)。
[概述]
觉得还是需要整理一下思路, 最近这个状态不太好, 每天晚上回来磨蹭磨蹭时间就过去了, 感觉很难集中时间来一下吧django啃掉,那就每次记录一点的,或许会好一些。
Django 的模板语言的设计原则在动力和易用性之间取得均衡.(功能要足够强大,还要容易使用), 如果你以前使用过 HTML,你会觉得很容易上手.如果有其它基于文本的模板语言的经验, 比如 Smarty 或 CheetahTemplate, 你会觉得..使用django模板..就象在自己家里一样. Templates一个模板就是一个文本文件. 通过模板可以生成任意的基于文本的格式文件(HTML, XML, CSV, etc.). 一个模板包含 变量, 当模板被求值时,这些变量就被它们的值代替.而 标签 则控制着模板的逻辑. 下面是一个最小化的模板,它演示了某些基本概念. 其中的每个元素都会在本文档的后面部分被详细解释.: {% extends "base_generic.html" %}
哲学 为什么使用基于文本的模板系统而不是基于 XML (类似 Zope 的 TAL)? 我们希望 Django 的模板语言能比那些 XML/HTML 模板更可用.在 World Online, 我们使用它处理 e-mails, JavaScript 和 CSV. 你能使用这种模板语言生成任何基于文本的格式. 哦,还有一个理由,那就是我们认为除非一个人有受虐趋向,否则谁也不愿意手工编辑 xml。 Variables变量的形式: {{ variable }}. 当模板引擎遇到一个变量时,就会对变量求值,并在变量所在的位置用变量的值取代变量名,然后输出. 使用句点 (.) 可以访问变量的属性. 幕后 技术上,当模板系统遇到 句点, 它会按顺序尝试进依次查询:
在上面的例子中, {{ section.title }} 会被 section 对象的 title 属性替换. 如果你用到的一个变量不存在,模板系统会插入一个值:TEMPLATE_STRING_IF_INVALID ,这个值在 settings 中定义, 默认设置是一个空的字符串. 参见下面的 使用内建参考 , 这会帮助你发现给定模板中有哪些变量可用. 你可以使用 过滤器 来修改变量的显示. 过滤器通过使用 过滤器 ,可以定制变量的显示格式。 过滤器的形式: {{ name|lower }}. 这将显示 {{ name }} 变量通过 lower 过滤后的值. 它将文本转换为小写. 使用管道符号 (|) 应用一个过滤器. 过滤器可以 "链接". 一个过滤器的输入作为下一个过滤器的输入: {{ text|escape|linebreaks }} 是一个常用过滤器组合,用于将文本内容转义然后将换行转换成 <p> 标签. 有些过滤器能接受参数. 一个带有参数的过滤器看起来这样: {{ bio|truncatewords:"30" }}. 它用来显示 bio 变量的前 30 个. 过滤器参数总是带有比引号. 下文中的 内建过滤器参考 描述了所有的内建过滤器. 标签标签看起来这样: {% 标签 %}. 标签比起变量来复杂的多: 它负责在输出中创建一些文本,执行循环或逻辑分支, 装入额外信息以供后面的模板变量使用等等. 有些标签要求有开始标记和结束标记 (也就是 {% tag %} ... 标签内容 ... {% endtag %}). 下文中的 内建标签参考 描述了所有的内建标签.你也可以创建你自己的标签, 如果你会写 Python 代码的话. 模板继承Django 模板引擎最强大的 -- 也是最复杂的 -- 部分是模板继承. 模板继承允许你建立一个基本的 "骨架" 模板, 它包含你所有最常用的站点元素并定义了一些可以被子模板覆盖的 块 . 通过下面的例子你很容易理解模板继承: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 我们称它为 base.html, 定义了一些简单的 HTML 骨架文档, 你可以把它用到一些简单两列的网页上. "子" 模板的任务就是用内容填写这些空白的内容块. 在这个例子里, {% block %} 标签定义了三个子模板要填写的 block . 所有的 block 标签告诉模板引擎,模板的这些部分可以被子模板覆盖. 一个子模板类似下面这样: {% extends "base.html" %}
这里的 {% extends %} 标签是最关键的. 它告诉模板引擎这个模板 "扩展" 了另一个模板. 当模板系统要应用该模板时,首先它会去寻找父模板--在这里是 "base.html" . 模板引擎会注意到在 base.html 里有三个 block 并用子模板的相关内容替换这些 block. 用 blog_entries 里的值填写父模板之后, 最后的输出可能看起来象这样: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 注意由于子模板并未定义 sidebar block, 父模板中的值就被保留. 对模板的继承层数,Django未做任何限制. 常用的一种模板继承方法是如下的三层: * 创建一个 ``base.html`` 模板,用它表现站点主要的外观。 下面是使用模板继承的一些小技巧: * 如果你在模板中使用了 ``{% extends %}`` ,那么它必须是这个模板中的第一个模板 tag,
最后, 提醒你不能在一个模板文件中定义多个相同名字的 {% block %} 标签. 使用内建参考Django 自带的 admin site 内建一个当前站点的所有模板标签及过滤器的参考. 要查阅这个参考, 进入 admin 站点,然后点击页面右上角的 "Documentation" 链接(如果你的语言选择的是中文,你会看到一个 "文档" 链接).. 这个参考分为四大部分:tags, filters, models, 和 views. tags 和 filters 部分描述了所有的内建标签(事实上, 下文中的标签和过滤器 参考直接来自那些页面)和所有自定义标签或过滤器 库(如果有的话). views 页是最有价值的.你站点中的每个 URL 都有一个入口在这儿, 点击这个 URL 你会看到:
每个 view 文档页还有一个 bookmarklet , 使用它你可以任意页跳回到这个 view 页. 由于 Django 站点通常会用到数据库对象, 文档页的 models 小节描述了系统中每个对象的类型及那个对象的所有可用字段. 总得来说, 文档页会告诉你给定模板的每个标签, 每个过滤器,每个变量和对象的细节信息. 自定义标签及过滤器库某些应用提供自定义标签和过滤器库. 要在一个模板中访问它们, 使用 {% load %} 标签: {% load comments %}
在上面这个例子里, load 标签载入 comments 标签库, 之后 comment_form 标签才能使用. 参考你的 admin 界面的文档部分你会发现一个自定义库的列表. {% load %} 标签可接受空隔分隔的多个库的名字作为参数. 比如: {% load comments i18n %}
自定义库及模板继承当你载入一个自定义标签或过滤器库, 只有当前模板可以使用这些标签/过滤器 -- 继承链中不论是父模板还是子模板都不能使用使用这些标签和过滤器. 举例来说, 如果一个模板 foo.html 内有 {% load comments %} 指令, 一个子模板(也就是一个模板内有 {% extends "foo.html" %} 指令将 不能 访问 comments 模板标签和过滤器. 子模板必须自己负责 {% load comments %} 才可以使用这个库. 这是为了模板逻辑的清晰性和可维护性有意而为的一个特性. 内建标签和过滤器参考下面的标签和过滤器参考就是为那些没有 admin 站点的可用的人准备的.由于 Django 是高度可定制的,你的 admin 里的关于标签和过滤器的参考可以认为是最可信的. 内建标签参考comment注释.模板引擎会忽略掉 {% comment %} 和 {% endcomment %} 之间的所有内容. cycle在循环时轮流使用给定的字符串列表中的值. 在一个循环中, 在循环过程中的每次循环里轮流使用给定的字符串列表元素: {% for o in some_list %}
在循环之外, 在你第一次调用它时给这些字符串值定义一个不重复的名字,然后在循环中使用这个名字: <tr class="{% cycle row1,row2,row3 as rowcolors %}">...</tr>
你可以使用任意数量的逗号分隔的值.只有一点请你注意,不要在值与值之间放任何空隔--仅仅只有一个逗号即可. debug输出完整的调试信息,包括当前的上下文及导入的模块信息. extends当前模板 扩展 父模板的一个信号(标记). 这个标签有两种使用方式: {% extends "base.html" %} (带双引号) 使用 "base" 作为要扩展的父模板的名字.或者 {% extends variable %} 使用 variable 的值作为要扩展的父模板的名字. 参阅 模板继承 以了解更多信息. filter用来过滤变量的值. 允许多级过滤, 并且他们可以带有参数运行 -- just like in variable syntax. 示例: {% filter escape|lower %}
firstof输出传递给它的第一个不是 False 的变量值. 如果所有的变量都是 False 那就不输出任何东西. 示例: {% firstof var1 var2 var3 %}
它等价于: {% if var1 %}
for循环. 比如要显示一个 athlete_list 中的全部运动员: <ul> 通过使用 {% for obj in list reversed %} 你也可以实现反序循环. 在循环过程中 for 循环会设置以下的一系列变量:
if{% if %} 标签对一个变量求值, 若这个变量为 "true" , 就输出 if 内容块: {% if athlete_list %}
在上例中, 如果 athlete_list 非空, 运动员人数就会通过 {{ athlete_list|length }} 就象你刚刚看到的, if 标签可以带一个 {% else %} 子句,用来当 if 测试失败后输出相应的内 if``标签可以使用 ``and,``or`` 或 not 来测试一系列变量或否定一个给定的变量: {% if athlete_list and coach_list %}
为避免造成歧义, if``标签不允许在一个 tag 中同时有 ``and 和 or 逻辑; 举个例子,下面这个语句不能工作: {% if athlete_list and coach_list or other_list %}
如果确实需要组合条件,可以使用嵌套的 if 实现相同的功能: {% if athlete_list %}
ifchanged检查一个变量自上次循环之后是否发生了改变.(我的理解:主要用于过滤掉重复的值) 'ifchanged' block标签用于循环中. 它根据自身上次的状态检查自己值, 只有值发生变化时才显示这个值: <h1>Archive for {{ year }}</h1>
ifequal若两个参数相等,输出一个内容块. 例子: {% ifequal user.id comment.user_id %}
如同 {% if %} tag, 它也支持一个可选的 {% else %} 子句. 参数可以是变量,也可以是字符串字面值, 也就是说下面这样也是合法的: {% ifequal user.username "adrian" %}
ifnotequal类似 ifequal, 只是它用来测试两个参数是否不等. include载入一个模板并根据当前上下文渲染它.用于在一个模板中包含其它模板. 模板名字可以是一个变量,也可以是一个字符串(带引号的字符串,无所谓单引号还是双引号). 下面这个例子包含了 "foo/bar.html" 模板的内容: {% include "foo/bar.html" %}
下面这个例子包含了另一个模板(该模板的名字为变量 template_name 的值)的内容: {% include template_name %}
被包含的模板使用包含它的模板的上下文(也就是环境)进行渲染(求值),下面这个例子输出 "Hello, John":
参阅: {% ssi %}. now显示当前日期, 根据给定的字符串决定输出格式. 使用和 PHP 的 date() 函数一样的格式码 (http://php.net/date) 并做了一些扩展 可用的格式字符串:
例子: It is {% now "jS F Y H:i" %}
注意你可以使用反斜线转义一个格式字符串中的敏感字符.(如果你想使用其原始值的话).在下面这个例子里, "f" 被用反斜线转义, 因为 "f" 本身是一个用于显示时间的格式字符. "o" 不需要被转义,因为它不是一个格式字符.: It is the {% now "jS o\f F" %}
(显示 "It is the 4th of September" %} regroupRegroup a list of alike objects by a common attribute. 要搞懂这个复杂的标签, 最好还是用一个例子来说明(一幅图胜过千句话): 有一个 people 对象,它是一个 Person 对象(拥有 first_name, last_name 及 gender 属性)的列表. 你想显示一个象下面这样的列表:
下面的模板代码片断可以完成这个看上去复杂的任务: {% regroup people by gender as grouped %}
如同你看到的, {% regroup %} 生成一个变量包含一个对象的列表. 列表中的每个对象都拥有 grouper 和 list 属性. grouper 装有分组的条目; list 包含一系列拥有共同 grouper 属性的对象. 在这个例子里, grouper 可能是 Male, Female 和 Unknown, 而 list 则是属于这几种性别的人的列表. 注意当这个被分组的列表没有按你要分组的键排序时, {% regroup %} 将不能工作! 这就是说你的 people 列表如果没有按 gender 排序, 你就必须得保证在使用它之前先将它排好序,也就是: {% regroup people|dictsort:"gender" by gender as grouped %}
spaceless将HTML标签之间的空白格式化为一个空格. 空白包括空格,换行,制表符. 示例: {% spaceless %}
这个例子将返回这样的HTML: <p> <a href="foo/">Foo</a> </p> 只有 标签 之间的空白被处理 -- 标签与文本之间的空白不会被处理.在下面这个例子里, Hello 周围的空白不会被缩小: {% spaceless %}
ssi在页面中输出给定文件的内容. 类似一个简单的 "include" 标签, {% ssi %} 包含另一个文件的内容 -- 不过必须在当前页面指定一个绝对路径 {% ssi /home/html/ljworld.com/includes/right_generic.html %}
如果提供了可选的 "parsed" 参数, 被包含文件的内容会使用当前的上下文作为模板代码进行求值处理.: {% ssi /home/html/ljworld.com/includes/right_generic.html parsed %}
注意如何你使用 {% ssi %}, 出于安全考虑, 你需要在你的 Django settings 文件中定义 ALLOWED_INCLUDE_ROOTS . 参阅: {% include %}. templatetag输出一个组成模板标签的字符. 由于模板系统没有 "转义" 的概念, 要显示一个组成模板标签的字符, 你必须使用 {% templatetag %} 标签. 用参数告诉标签输出哪些内容:
widthratio要创建柱形图的话, 这个标签计算给定值与最大值的比率再乘以100,四舍五入为整数,最后输出这个整数. 例子: <img src="bar.gif" height="10" width="{% widthratio this_value max_value 100 %}" />
上例中, 如果 this_value 是 175 而 max_value 是 200, 则上例中的图片应该是 88 像素宽 (因为 175/200 = .875; .875 * 100 = 87.5 四舍五入为 88). 内建过滤器参考add返回参数与被处理数据相加的结果. addslashes给敏感字符添加斜线(转义). 举例,要将一个字符串传递给 JavaScript 时.. capfirst大写被处理数据的第一个字母. center按给定宽度将待处理数据居中. cut将待处理数据中的所有子串删除(该子串等于 cut 的参数) date根据给定的格式(与 now 标签相同)格式化一个日期. default如果值不可用,使用提供的默认值. default_if_none如果值为 None, 使用这个给定的默认值. dictsort接受一个字典列表,返回按给定参数的属性排序后的列表. dictsortreversed接受一个字典列表,返回按给定参数的属性逆序排序后的列表. divisibleby如果值可以被参数除尽,则返回 True. escape对一个字符串的敏感字符进入转义(以用于HTML). 特别是它会做如下替换:
filesizeformat将值格式化为 '可读性好的' 文件大小(比如 '13 KB', '4.1 MB', '102bytes' 等等). first返回列表中的第一个元素. fix_ampersands将 & 符号替换为 & 实体. get_digit提供一个完整的数, 返回该数中被请求的数字,其中 1 是最右边的数, 2 是从右边数第二个数字等等. 若输入值非法(若输入或参数不是整数, 或者参数小于1)则返回其原始值. 否则输出就总是整数. join用一个字符串将一个列表连接起来, 类似 Python 的 str.join(list). length返回值的长度. 对列表特别有用. length_is若值的长度与参数相等,返回 True, 否则返回 False. linebreaks将换行符转化为 <p> 和 <br />. linebreaksbr将换行符转化为 <br />. linenumbers带行号显示文本. lower将字符串转化为小写. make_list将值转化为一个列表.对一个整数,它是一个数字的列表.对一个字符串,这是一个字符的列表. phone2numeric将一个电话号码(可能包含字母)转化等价的数字值.比如: '800-COLLECT' 将被转化为 '800-2655328'. 输入不一定非是一个合法号码. 它可以转化任意字符串. pluralize如果值不是 1 的话返回 's' 用于 '1 vote' vs. '2 votes' 这种场合. 例如: you have {{number_messages}} mail{{number_messages|pluralize}}.
pprintpprint.pprint 和一个封装器-- 仅用于调试. random返回随机的从列表中返回一个元素 removetags从输出中删除单空格分隔的 [X]HTML标签 列表 slice返回一个列表的片段. 使用与 Python 的 list 相同的语法, 参阅 http://diveintopython.org/native_data_types/lists.html#odbchelper.list.slice 以了解更详细的信息. 示例: {{ some_list|slice:":2" }} slugify转化为小写, 移去非单词字符(字母数字和下划线),将空白转化为连字符,去除前后空白. stringformat根据给定参数(一个格式字符串)格式化一个变量, 这个格式字符串使用 Python 字符串格式化语法, 例外之处是 "%" 运算符被省略. 参阅 http://docs.python.org/lib/typesseq-strings.html 以了解 Python 格式字符串 striptags过滤掉[X]HTML标签. time根据给定的格式, 格式化一个时间(与 now 标签使用的格式相同). timesince格式化一个日期,这个日期是从给定日期到现在的天数和小时数(比如: "4 days, 6 hours"). 接受一个可选的参数,该参数是一个包含比较日期的变量(该参数默认值是 now). 举例来说, 如果 blog_date 是一个日期实例表示 2006-06-01 午夜, 而 comment_date 是一个日期实例表示 2006-06-01 早上8点,那么 {{ comment_date|timesince:blog_date }} 将返回 "8 hours". timeuntil类似 timesince, 只是它比较当前时间直到给定日期时间。举例来说,如果今天是 2006-06-01 而 conference_date 是 2006-06-29, 那么 {{ conference_date|timeuntil }} 将返回 "28 days". 接受一个可选的参数,该参数是一个包含比较日期的变量(该参数默认值是 now). 举例来说, 如果 from_date 是一个日期实例表示 2006-06-22, 那么 {{ conference_date|timeuntil:from_date }} 会返回 "7 days". title按标题格式转化一个字符串 unordered_list递归的接受一个自嵌套的列表并返回一个HTML无序列表(此列表可不是pythob语义中的列表) -- 只是没有开始和结束的<ul>标签. 假定该列表是合适的格式. 举例来说, 如果 var 的值为 ['States', [['Kansas', [['Lawrence', []], ['Topeka', []]]], ['Illinois', []]]], 那么 {{ var|unordered_list }} 就会返回: <li>States upper将一个字符串全部转为大写. urlencode转义该值以用于 URL. urlize将普通文本的 URL 转化为可点击的链接. wordcount返回单词数 yesno提供一个字符串参数对应着 true, false 和 (可选的) None, 根据被处理的值返回相应的字符串:
其它 tags 和 filter 库Django 自带了几个其它的模板 tag 库,要使用这些 tag 库,必须显式的在 INSTALLED_APPS 设置中启用他们,然后在模板中使用 {% load %} tag 载入他们. django.contrib.humanize一堆 Django 模板过滤器,用于生成易读的数据,参阅 humanize documentation.
|






