تابع STR در SQL Server تابعی است که خروجی آن از نوع VARCHAR بوده و عددهایی که به کاراکتر تبدیل شده اند را نمایش می دهد. پس به این آرگومان باید داده هایی از نوع عدد را پاس دهید و خروجی رشته بگیرید. ضمنا این تابع دو پارامتر اختیاری دیگر هم می گیرد که یکی برای تعیین طول و دیگری برای تعداد ارقام پس از اعشار است.


Syntax استفاده از این تابع بصورت زیر می باشد:

STR ( float_expression [ , length [ , decimal ] ] )

لطفا به مثال ساده زیر دقت کنید:

SELECT STR(123.45) AS Result;

+------------+

| Result     |

|------------|

|        123 |

+------------+

بصورت پیشفرض عدد اعشاری به یک عدد صحیح گرد می شود. مثلا اگر در مثال فوق، قسمت اعشار که 45 است را به 55 گرد کنید، خروجی به یک عدد صحیح بزرگتر گرد می شود.

SELECT STR(123.55) AS Result;

+------------+

| Result     |

|------------|

|        124 |

+------------+

هنگام استفاده از پارامتر اختیاری length، مقدار آن باید بزرگتر یا مساوی قسمت شماره قبل از رقم اعشار به علاوه علامت عدد باشد. در مثال زیر، مقدار length بیش از قسمت عدد قبل از نقطه اعشاری است:

SELECT STR(123.55, 4) AS Result;

+----------+

| Result   |

|----------|

|  124     |

+----------+

اگر مقدار length کوچکتر از تعداد ارقام قبل از اعشار باشد، خروجی زیر را دریافت می کنید:

SELECT STR(123.55, 2) AS Result;

+----------+

| Result   |

|----------|

| **       |

+----------+

همچنین توجه داشته باشید که length، طول خروجی را تعیین می کند که شامل اعشار ، علامت ، رقم و فاصله ها است. طول پیش فرض 10 است.

SELECT

  123 AS '123',

  STR(123, 3) AS '3',

  STR(123, 10) AS '10',

  STR(123, 16) AS '16';

+-------+-----+------------+------------------+

| 123   | 3   | 10         | 16               |

|-------+-----+------------+------------------|

| 123   | 123 |        123 |              123 |

+-------+-----+------------+------------------+

در مثال زیر که مشابه مثال فوق است، یکی از خروجی ها را با تابع TRIM ادغام می کنیم و فاصله قبل از کاراکتر خروجی 123 را میگیریم و با خروجی بعدی که TRIM نشده است، مقایسه می کنیم:

SELECT

  TRIM(STR(123, 16)) AS 'A',

  STR(123, 16) AS 'B';

+-----+------------------+

| A   | B                |

|-----+------------------|

| 123 |              123 |

+-----+------------------+

مثال بعدی با استفاده از پارامتر decimal است که البته این پارامتر هم اختیاری است و خروجی آن را خواهیم دید:

SELECT STR(123.55, 8, 4) AS Result;

+----------+

| Result   |

|----------|

| 123.5500 |

+----------+

در این مثال پارامتر length افزایش داده شد تا بتواند رقم های اعشار را در خود جای دهد.
اگر Length را کم کنید، خروجی زیر را بدست می آورید:

SELECT STR(123.55, 6, 4) AS Result;

+----------+

| Result   |

|----------|

| 123.55   |

+----------+