文件首頁
MySQL 8.4 參考手冊
相關文件 下載本手冊
PDF (美式信紙) - 39.9Mb
PDF (A4) - 40.0Mb
Man Pages (TGZ) - 258.5Kb
Man Pages (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 參考手冊  /  ...  /  GeometryCollection 屬性函數

14.16.7.5 GeometryCollection 屬性函數

這些函數會傳回 GeometryCollection 值的屬性。

除非另有說明,否則本節中的函數會以如下方式處理其幾何引數:

  • 如果任何引數為 NULL 或任何幾何引數為空的幾何,則傳回值為 NULL

  • 如果任何幾何引數不是語法正確的幾何,則會發生 ER_GIS_INVALID_DATA 錯誤。

  • 如果任何幾何引數是未定義空間參考系統 (SRS) 中語法正確的幾何,則會發生 ER_SRS_NOT_FOUND 錯誤。

  • 否則,傳回值為非 NULL

這些函數可用於取得幾何集合屬性

  • ST_GeometryN(gc, N)

    傳回 GeometryCollectiongc 中的第 N 個幾何。幾何從 1 開始編號。

    ST_GeometryN() 會依照本節簡介所述處理其引數。

    mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
    mysql> SELECT ST_AsText(ST_GeometryN(ST_GeomFromText(@gc),1));
    +-------------------------------------------------+
    | ST_AsText(ST_GeometryN(ST_GeomFromText(@gc),1)) |
    +-------------------------------------------------+
    | POINT(1 1)                                      |
    +-------------------------------------------------+
  • ST_NumGeometries(gc)

    傳回 GeometryCollectiongc 中的幾何數量。

    ST_NumGeometries() 會依照本節簡介所述處理其引數。

    mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
    mysql> SELECT ST_NumGeometries(ST_GeomFromText(@gc));
    +----------------------------------------+
    | ST_NumGeometries(ST_GeomFromText(@gc)) |
    +----------------------------------------+
    |                                      2 |
    +----------------------------------------+