过滤函数引用¶

此引用描述可在WFS/WMS筛选或SLD表达式中使用的所有筛选函数。

可通过浏览至http://localhost:8080/geoserver/wfs?request=GetCapabilities并搜索以下内容来确定地理服务器实例上可用的函数列表 ogc:Function_Names (WFS 1.0.0)、 ogc:FunctionNames (WFS 1.1.0)，或 fes:Functions (WFS 2.0.0)。如果功能文档中描述了某个函数，但该参考中没有该函数，则可能意味着该函数不能用于过滤，或者它是新的并且没有文档记录。询问用户邮件列表的详细信息。

除非另有规定，否则数据存储对该引用中的任何筛选器函数都不会进行本机理解，因此使用这些函数的表达式将在内存中进行计算。

函数参数类型引用¶

Type	Description
双重的	浮点数，8字节，IEEE 754。范围从4.94065645841246544E-324D到1.79769313486231570E+308D
浮标	浮点数，4字节，IEEE 754。范围从1.401298432481707E-45到3.40282346638528860E+38。范围小，比双精度差。
整数	整数，范围从-2147483648到2147483647
长	整数，范围从-9223372036854775808到+9223372036854775807
数	任何类型的数值
对象	任何类型的值
弦	一系列字符
时间戳	日期和时间信息

比较函数¶

Name	Arguments	Description
之间	`num` ：数字， `low` ：数字， `high` ：数字	返回true `low` <= `num` <= `high`
等于	`a` ：对象， `b` ：对象	可用于比较相等的两个数字、两个字符串、两个日期等
大于等于	`x` ：对象， `y` ：对象	返回true `x` > `y` .参数可以是数字或字符串（在第二种情况下，使用字典排序）
大于	`x` ：对象， `y` ：对象	返回true `x` > `y` .参数可以是数字或字符串（在第二种情况下，使用字典排序）
in2、in3、in4、in5、in6、in7、in8、in9、in10	`candidate` ：对象， `v1` ：对象，…， `v9` ：对象	返回true `candidate` 等于 `v1` … `v9` 价值观。使用与指定参数数匹配的函数名。
在里面	`candidate` ：对象， `v1` ：对象， `v2` ：对象，…	其工作原理与上面描述的in2，…，in10函数完全相同，但接受任意数量的值作为输入。
像岛一样	`string` ：字符串， `pattern` ：字符串	如果字符串与指定的模式匹配，则返回true。有关模式规范的完整语法，请参阅 Java Pattern class javadocs
是空的	`obj` ：对象	返回true。传递的参数为 `null` ，否则为false
雷斯坦	`x` ：对象， `y` ：对象	返回true `x` < `y` .参数可以是数字或字符串（在第二种情况下，使用词典排序）
莱塞科尔坦	`x` ：对象， `y` ：对象	返回true `x` <= `y` .参数可以是数字或字符串（在第二种情况下，使用词典排序）
不	`bool` ：布尔值	返回的否定 `bool`
非相等收件人	`x` ：对象， `y` ：对象	返回true `x` 和 `y` 相等，否则为假

控制功能¶

Name	Arguments	Description
if_then_else	`condition` ：布尔值， `x` ：对象， `y` ：对象	返回 `x` 如果条件是真的， `y` 否则

环境功能¶

此函数返回在各种上下文中定义的环境变量的值。WMS GetMap会自动定义一些变量 SLD rendering ，而其他则可以使用 env 请求参数。例如，动态符号化程序中的用法示例：

${env('size', 20)}

默认符号化程序中的用法示例：

<PointSymbolizer uom="http://www.opengeospatial.org/se/units/metre">
  <Graphic>
  ...
    <Size>
      <ogc:Function name="env">
        <ogc:Literal>size</ogc:Literal>
        <ogc:Literal>20</ogc:Literal>
      </ogc:Function>
    </Size>
  </Graphic>
</PointSymbolizer>

Name	Arguments	Description
埃恩	`variable` ：字符串	返回环境变量的值 `variable` .

功能¶

Name	Arguments	Description
身份证件	`feature` ：功能	返回功能的标识符
PropertyExists	`f` ：功能， `propertyName` ：字符串	返回 `true` 如果 `f` 具有名为的属性 `propertyName`
属性	`f` ：功能， `propertyName` ：字符串	返回属性的值 `propertyName` .允许属性名由计算或指定 SLD中的变量替换 .
地图员	`f` ：功能， `map` ：地图， `key` ：字符串	获取地图的值 `map` 与指定的 `key` .

空间关系函数¶

有关空间关系的精确含义的更多信息，请参阅 OGC Simple Feature Specification for SQL

Name	Arguments	Description
包含	`a` ：几何图形， `b` ：几何图形	如果几何图形 `a` 包含 `b`
十字架	`a` ：几何图形， `b` ：几何图形	返回true `a` 十字架 `b`
不相交	`a` ：几何图形， `b` ：几何图形	如果两个几何体不相交，则返回“真”，否则返回“假”。
平等行为	`a` ：几何图形， `b` ：几何图形	如果两个几何图形完全相同，则返回“真”，坐标顺序相同
等容限	`a` ：几何图形， `b` ：几何图形， `tol` ：双	如果两个几何图形完全相同，则返回“真”，坐标顺序相同，允许 `tol` 对应点距离
相交	`a` ：几何图形， `b` ：几何图形	返回true `a` 相交 `b`
不谨慎	`a` ：几何图形， `b` ：几何图形， `distance` ：双	如果之间的距离 `a` 和 `b` 小于 `distance` （以欧几里得距离测量）
重叠	`a` ：几何图形， `b` ：几何图形	返回true `a` 与…重叠 `b`
有联系	`a` ：几何图形， `b` ：几何图形	返回的de-9im交集矩阵 `a` 和 `b`
中继模式	`a` ：几何图形， `b` ：几何图形， `pattern` ：字符串	如果的de-9im交集矩阵 `a` 和 `b` 匹配指定的模式
触摸	`a` ：几何图形， `b` ：几何图形	返回true `a` 触摸 `b` 根据SQL简单特性规范规则
在内部	`a` ：几何图形， `b` ：几何图形	返回的true完全包含在 `b`

几何函数¶

Name	Arguments	Description
地区	`geometry` ：几何图形	指定几何图形的区域。在笛卡尔平面中工作，结果将与几何坐标处于相同的度量单位（这也意味着结果对地理数据没有任何意义）。
边界	`geometry` ：几何图形	返回几何图形的边界
边界尺寸	`geometry` ：几何图形	返回几何图形边界的维数
缓冲区	`geometry` ：几何图形， `distance` ：双	使用指定的距离返回几何体周围的缓冲区域
带段的缓冲区	`geometry` ：几何图形， `distance` ：双重， `segments` ：整数	使用指定的距离和指定的段数返回几何图形周围的缓冲区域，以表示圆的象限。
质心	`geometry` ：几何图形	返回几何体的质心。可以经常用作多边形的标签点，尽管不能保证它实际上位于几何体内部
凸壳	`geometry` ：几何图形	返回指定几何体的凸壳
差异	`a` ：几何图形， `b` ：几何图形	返回所有位于 `a` 但不在 `b`
维	`a` ：几何图形	返回指定几何图形的尺寸
距离	`a` ：几何图形， `b` ：几何图形	返回两个几何体之间的欧几里得距离
恩丹格尔	`line` ：行字符串	返回LineString结束段的角度
终结点	`line` ：行字符串	返回LineString的端点
信封	`geometry` ：几何图形	返回表示几何图形信封的多边形，即边与包含该几何图形的轴平行的最小矩形
外观	`poly` ：多边形	返回指定多边形的外环
几何类型	`geometry` ：几何图形	以字符串形式返回几何图形的类型。可能是 `Point` ， `MultiPoint` ， `LineString` ， `LinearRing` ， `MultiLineString` ， `Polygon` ， `MultiPolygon` ， `GeometryCollection`
GEOMFROMWKT公司	`wkt` ：字符串	返回 `Geometry` 以包含在 `wkt` 参数
几何长度	`geometry` ：几何图形	返回此几何图形的长度/周长（以笛卡尔空间计算）
几何图形	`collection` ：几何集合， `n` ：整数	返回集合中的第n个几何图形
GETX公司	`p` ：点	返回 `x` 纵坐标 `p`
格蒂	`p` ：点	返回 `y` 纵坐标 `p`
格茨	`p` ：点	返回 `z` 纵坐标 `p`
内部点	`geometry` ：几何图形	如果可能，返回几何图形内部或位于其边界上的点，否则返回
内部环	`polyg` ：多边形， `n` ：整数	返回多边形的第n个内环
交叉	`a` ：几何图形， `b` ：几何图形	返回 `a` 和 `b` .交叉点结果可以是任何内容，包括异类的几何集合，如果结果为空，则将由空集合表示。
已关闭	`line` ：行字符串	返回true `line` 形成一个闭合环，也就是说，如果第一个和最后一个坐标相等
栈空	`geometry` ：几何图形	如果几何图形不包含任何点，则返回“真”（典型情况下，为空几何图形集合）
等距的	`geometry` ：几何图形， `extrusion` ：双	返回包含输入几何图形所有组件的等距拉伸的多多边形。挤出距离为 `extrusion` ，以与几何坐标相同的单位表示。可用于在地图中获得伪三维效果
以色列	`line` ：行字符串	如果 `line` 实际上是一个闭合环（相当于 `isRing(line) and isSimple(line)` ）
I示例	`line` ：行字符串	如果几何体仅在边界点自相交，则返回“真”
有效	`geometry` ：几何图形	如果几何图形在拓扑上有效（环闭合，孔在Shell内部，等等），则返回true。
数字几何	`collection` ：几何集合	返回几何集合中包含的几何图形数
麻木	`poly` ：多边形	返回指定多边形内的内环（孔）数
数字	`geometry` ：几何图形	返回包含在 `geometry`
抵消	`geometry` ：几何图形， `offsetX` ：双重， `offsetY` ：双	按指定的X和Y偏移偏移几何图形中的所有点。偏移与几何体自身的坐标在同一坐标系中工作。
点	`geometry` ：几何图形， `n` ：整数	返回指定几何图形中的第n个点
起始角度	`line` ：行字符串	返回输入字符串起始段的角度
起点	`line` ：行字符串	返回输入字符串的起始点
共鸣	`a` ：几何图形， `b` ：几何图形	返回 `a` 和 `b` （所有在里面的点 `a` 或 `b` ，但不是两者）
拖车	`geometry` ：几何图形	返回的WKT表示形式 `geometry`
联盟	`a` ：几何图形， `b` ：几何图形	返回的并集 `a` 和 `b` （结果可能是几何集合）
顶点	`geom` ：几何图形	返回使用所有顶点创建的多点 `geom`

数学函数¶

Name	Arguments	Description
防抱死制动系统	`value` ：整数	指定整数的绝对值 `value`
abs_2	`value` ：长	指定长度的绝对值 `value`
abs_3	`value` ：浮动	指定浮点的绝对值 `value`
abs_4	`value` ：双	指定双精度数的绝对值 `value`
蚁群算法	`angle` ：双	返回 `angle` 以弧度表示，范围为0.0到 `PI`
阿辛	`angle` ：双	返回 `angle` 以弧度表示，范围为 `-PI / 2` 通过 `PI / 2`
阿坦	`angle` ：双	返回以弧度表示的角度的反正切值，范围为 `-PI/2` 通过 `PI/2`
阿坦2	`x` ：双重， `y` ：双	转换直角坐标 `(x, y)` 到极地（R，θ）回报 θ .
塞尔	`x` ：双	返回大于或等于的最小（最接近负无穷大）双精度值 `x` 等于一个数学整数。
余弦	`angle` ：双	返回 `angle` 以弧度表示
双布尔	`x` ：双	返回 `true` 如果 `x` 是零， `false` 否则
EXP	`x` ：双	返回欧拉数 e 提升到 `x`
地板	`x` ：双	返回小于或等于的最大值（最接近正无穷大） `x` 等于一个数学整数
IEEERemainder	`x` ：双重， `y` ：双	计算 `x` 除以 `y` 按照IEEE 754标准的规定
Int2bBool公司	`x` ：整数	返回true `x` 为零，否则为假
INT2DOUBLE公司	`x` ：整数	皈依者 `x` 到双人间
日志	`x` ：整数	返回自然对数（底端 `e` 的） `x`
最大值，最大值3，最大值4	`x1` ：双重， `x2` ：双重， `x3` ：双重， `x4` ：双	返回最大值 `x1` … `x4`
最小值，最小值3，最小值4	`x1` ：双重， `x2` ：双重， `x3` ：双重， `x4` ：双	返回介于 `x1` … `x4`
圆周率	没有	返回的近似值 `pi` 圆的周长与直径之比
功率	`base` ：双重， `exponent` ：双	返回的值 `base` 提升到 `exponent`
随机的	没有	返回一个正号大于或等于的双精度值 `0.0` 小于 `1.0` .返回值是从该范围（近似）均匀分布的伪随机选择的。
打印	`x` ：双	返回与参数值最接近且等于数学整数的双精度值。如果两个数学整数的双精度值相等，则结果是偶数的整数值。
round_2	`x` ：双	等同于 `round` ，但返回一个长
圆	`x` ：双	返回最接近的整数 `x` .将结果四舍五入为整数，方法是添加1/2，取结果的底端，然后将结果强制转换为类型整数。换句话说，结果等于表达式的值 `(int)floor(a + 0.5)`
双轮手枪	`x` ：双	返回最接近的长 `x`
罪	`angle` ：双	返回 `angle` 以弧度表示
棕褐色的	`angle` ：双	返回的三角切线 `angle` 以弧度表示
今日	`angle` ：双	将以弧度表示的角度转换为度
辐照度	`angle` ：双	将以弧度表示的角度转换为度

字符串函数¶

字符串函数通常接受 String 论据。非字符串值将自动转换为字符串表示形式。

Name	Arguments	Description
连接	`s1` ：字符串， `s2` ：字符串，…	连接任意数量的字符串。允许使用非字符串参数。
删除	`sentence` ：字符串， `lower` ：整数， `upper` ：整数， `append` ：字符串	将句子的第一个空格缩写为 `lower` （或在 `upper` 如果没有空间）。附录 `append` 如果字符串被缩写。
大写	`sentence` ：字符串	把句子大写。例如，“你好吗？”会变成“你好吗？”
Strconcat公司	`a` ：字符串， `b` ：字符串	将两个字符串连接成一个
strdefaultifblank	`str` ：字符串， `default` ：字符串	收益率 `default` 如果 `str` 为空、空白或空
加强	`string` ：字符串， `suffix` ：字符串	返回true `string` 以结束 `suffix`
StrequalignoreCase	`a` ：字符串， `b` ：字符串	如果两个字符串相等，忽略大小写考虑，则返回true
斯特林德索夫	`string` ：字符串， `substring` ：字符串	返回指定子字符串第一次出现的字符串中的索引，或者 `-1` 如果找不到
strLastIndexOf	`string` ：字符串， `substring` ：字符串	返回指定子字符串最后一次出现的字符串中的索引，或者 `-1` 如果找不到
长度	`string` ：字符串	返回字符串长度
strmatches公司	`string` ：字符串， `pattern` ：字符串	如果字符串与指定的正则表达式匹配，则返回true。有关模式规范的完整语法，请参阅 Java Pattern class javadocs
strreplace	`string` ：字符串， `pattern` ：字符串， `replacement` ：字符串， `global` ：布尔值	返回用给定替换文本替换模式的字符串。如果 `global` 论证是 `true` 然后将替换所有出现的模式，否则仅替换第一个。有关模式规范的完整语法，请参阅 Java Pattern class javadocs
StrStartsWith（StrStartsWith）	`string` ：字符串， `prefix` ：字符串	返回true `string` 从开始 `prefix`
strStripAccents	`string` ：字符串	从字符串中删除音调符号（~=重音符号）。此案将不予更改。
strsubstring	`string` ：字符串， `begin` ：整数， `end` ：整数	返回此字符串的子字符串。子字符串从指定的 `begin` 扩展到索引处的字符 `endIndex - 1` （索引以零为基础）。
strSubStringStart（strSubStringStart）	`string` ：字符串， `begin` ：整数	返回此字符串的子字符串。子字符串从指定的 `begin` 并扩展到字符串的最后一个字符
strtolowercase公司	`string` ：字符串	返回字符串的小写版本
StrtoUppercase公司	`string` ：字符串	返回字符串的大写版本
斯特里姆	`string` ：字符串	返回字符串的副本，省略前导空格和尾随空格

解析和格式化函数¶

Name	Arguments	Description
日期格式	`format` ：字符串， `date` ：时间戳	根据提供的格式设置指定日期的格式。格式语法可以在 Java SimpleDateFormat javadocs
日期分析	`format` ：字符串， `dateString` ：字符串	解析来自的日期 `dateString` 格式根据 `format` 规范。格式语法可以在 Java SimpleDateFormat javadocs
数字格式	`format` ：字符串， `number` ：加倍， `locale` ：字符串	根据指定的 `format` 使用默认区域设置或提供的区域设置作为可选参数。格式语法可以在 Java DecimalFormat javadocs
分析布尔值	`boolean` ：字符串	将字符串解析为布尔值。空字符串， `f` ， `0.0` 和 `0` 被认为是错误的，其他的都被认为是正确的。
分析双精度	`number` ：字符串	将字符串解析为双精度字符串。数字可以用正常或科学的形式表示。
帕森特	`number` ：字符串	将字符串解析为整数。
帕塞隆	`number` ：字符串	将字符串解析为长整数

时间函数¶

Name	Arguments	Description
日期差异	`a` ：日期： `b` ：日期： `timeUnits` ：字符串	计算两个日期之间的差值(以a-b表示)并返回以特定时间单位表示的结果。 `timeUnits` 是可选的，表示所需的时间单位结果。默认为毫秒。可能的值包括 `s` (秒)， `m` (分钟)， `h` (小时)、 `d` (天)。
现在	没有	以日期形式返回当前时间

转换函数¶

转换函数将值从一个数据空间转换为另一个数据空间。这些函数提供了一种从特征属性值计算样式参数的简洁方法。另请参见使用转换函数设置样式 .

Name	Arguments	Description
重新编码	`lookupValue` ：对象， `data` ：对象， `value` ：对象，…	转换 `lookupValue` from a set of discrete data values into another set of values. Any number of `data`/`value` 可以指定对。
分类	`lookupValue` ：对象， `value` ：对象， `threshold` ：对象，… `value` ：对象， `belongsTo` ：字符串	将连续值属性值转换为一组离散值。 `lookupValue` and `value` must be an orderable type (typically numeric). The initial `value` is required. Any number of additional `threshold`/`value` 可以指定对。 `belongsTo` 是可选的，具有值 `succeeding` 或 `preceding` .它定义查找值等于阈值时要使用的间隔。
插入	`lookupValue` ：数字， `data` ：数字， `value` ：数字 or #RRGGBB，… `mode` ：字符串， `method` ：字符串	将连续值属性值转换为另一个连续值范围。任何数量的 `data`/`value` 可以指定对。 `mode` 是可选的，具有值 `linear` ， `cosine` 或 `cubic` .它定义了要使用的插值算法。 `method` 是可选的，具有值 `numeric` 或 `color` .它定义目标值是数值还是RGB颜色规格。

Previous: 过滤器功能

Next: 服务器配置