استفاده از دستور substring در سی‌شارپ

استفاده از دستور Substring در سی‌شارپ

در برنامه‌نویسی، کار با رشته‌ها یا String یکی از مهم‌ترین بخش‌های توسعه نرم‌افزار است.
در بسیاری از پروژه‌ها لازم است بخشی از یک متن را جدا کنیم، چند کاراکتر مشخص را استخراج کنیم یا اطلاعات خاصی را از داخل یک رشته دریافت کنیم.
در زبان برنامه‌نویسی #C برای انجام این کار می‌توان از متد قدرتمند Substring استفاده کرد.
متد Substring یکی از متدهای کاربردی کلاس String در سی‌شارپ است که امکان استخراج بخشی از یک رشته را در اختیار برنامه‌نویس قرار می‌دهد. 

متد Substring در سی‌شارپ چیست؟

متد Substring برای جدا کردن بخشی از یک رشته متنی استفاده می‌شود.
با استفاده از این متد می‌توان مشخص کرد استخراج متن از چه موقعیتی شروع شود و در صورت نیاز، چند کاراکتر از رشته انتخاب شوند.
برای مثال، فرض کنید رشته زیر را داریم:

string text = "Hello World";

اگر بخواهیم بخشی از این متن را استخراج کنیم، می‌توانیم از Substring استفاده کنیم:

string result = text.Substring(0, 5);
Console.WriteLine(result);

خروجی کد بالا به شکل زیر خواهد بود:

Hello

در این مثال، عدد 0 موقعیت شروع و عدد 5 تعداد کاراکترهایی است که باید استخراج شوند.

آیا به دنبال یک فرصت عالی برای یادگیری برنامه‌نویسی هستید؟ 🚀

با دوره آموزشی سی‌شارپ ما، شما می‌توانید مهارت‌های خود را به سطح جدیدی ارتقا دهید! این دوره به‌طور کامل طراحی شده تا به شما کمک کند تا از مبتدی تا پیشرفته در دنیای برنامه‌نویسی سی‌شارپ پیش بروید.

👨‍🏫 چرا دوره ما را انتخاب کنید؟

• محتوای جامع و عملی: با پروژه‌های واقعی و تمرینات عملی، یادگیری را به تجربه‌ای جذاب تبدیل کنید.
• مدرس مجرب: از تجربه و دانش مدرس حرفه‌ای بهره‌مند شوید که شما را در هر مرحله از یادگیری راهنمایی می‌کنند.
• پشتیبانی ۲۴/۷: هر زمان که سوالی داشتید، ما در کنار شما خواهیم بود تا به شما کمک کنیم.
• دسترسی مادام‌العمر: به محتوای دوره دسترسی دائمی داشته باشید و هر زمان که خواستید، می‌توانید به آن مراجعه کنید.

💡 فرصت را از دست ندهید!

بایادگیری سی‌شارپ، می‌توانید در دنیای فناوری اطلاعات به یک متخصص تبدیل شوید و در پروژه‌های جذاب و چالش‌برانگیز شرکت کنید.

همین امروز به جمع یادگیرندگان ما بپیوندید و اولین قدم را به سوی آینده‌ای روشن‌تر بردارید!

شرکت در دوره آموزش برنامه نویسی سی شارپ

ساختار دستور Substring در #C

متد Substring در سی‌شارپ می‌تواند با دو شکل اصلی مورد استفاده قرار بگیرد:

string.Substring(startIndex)

و:

string.Substring(startIndex, length)

پارامتر startIndex مشخص می‌کند عملیات استخراج از کدام موقعیت رشته آغاز شود.
پارامتر length نیز تعداد کاراکترهایی را مشخص می‌کند که باید از رشته استخراج شوند.
نکته مهم این است که شمارش موقعیت کاراکترها در C# از صفر شروع می‌شود. به عنوان مثال:

H e l l o
0 1 2 3 4

بنابراین اگر بخواهیم از کاراکتر سوم شروع کنیم، باید مقدار 2 را به عنوان startIndex قرار دهیم.

استفاده از Substring با یک پارامتر

در صورتی که فقط startIndex را مشخص کنیم، Substring تمام کاراکترها را از موقعیت مشخص‌شده تا انتهای رشته برمی‌گرداند.
مثال:

string text = "Programming";
string result = text.Substring(3);
Console.WriteLine(result);

خروجی:

gramming

در این مثال استخراج از موقعیت 3 آغاز شده و چون مقدار length مشخص نشده است، تمام متن باقی‌مانده برگردانده می‌شود.
این روش زمانی کاربرد زیادی دارد که بخواهیم بخشی از یک رشته را از یک نقطه مشخص تا انتهای آن دریافت کنیم.

استفاده از Substring با دو پارامتر

در بسیاری از مواقع لازم است هم نقطه شروع و هم تعداد کاراکترهای موردنظر را مشخص کنیم.
برای مثال:

string text = "Programming";
string result = text.Substring(0, 7);
Console.WriteLine(result);

خروجی:

Program

در اینجا:

• 0 نقطه شروع است.
• 7 تعداد کاراکترها است.

بنابراین متد Substring از ابتدای رشته، هفت کاراکتر را استخراج می‌کند.

کاربرد Substring در پروژه‌های واقعی

استفاده از Substring فقط به مثال‌های ساده محدود نمی‌شود.
این متد در پروژه‌های واقعی کاربردهای متنوعی دارد.
برای مثال فرض کنید یک کد محصول داریم:

string productCode = "PRD-2026-10025";

اگر بخواهیم سال ثبت محصول را استخراج کنیم، می‌توانیم بنویسیم:

string year = productCode.Substring(4, 4);
Console.WriteLine(year);

 

خروجی:

2026

همچنین می‌توان از Substring برای جدا کردن بخش‌هایی از شماره، کد شناسایی، شناسه کاربر، متن‌های طولانی و داده‌های دریافت‌شده از API استفاده کرد.

استفاده از Substring برای کوتاه کردن متن

یکی از کاربردهای رایج Substring در طراحی سایت و نرم‌افزار، کوتاه کردن متن است.
فرض کنید توضیحات یک محصول بسیار طولانی است و می‌خواهیم فقط 100 کاراکتر اول آن را نمایش دهیم:

string description = "این محصول یکی از محصولات کاربردی فروشگاه است که امکانات متنوعی را در اختیار کاربران قرار می‌دهد...";
string shortDescription = description.Substring(0, 100);
Console.WriteLine(shortDescription);

البته در چنین شرایطی باید قبل از اجرای Substring طول رشته را بررسی کنیم؛ زیرا اگر متن کمتر از 100 کاراکتر باشد، اجرای کد می‌تواند با خطا مواجه شود.
یک روش ایمن‌تر:

string shortDescription = description.Length > 100
    ? description.Substring(0, 100)
    : description;

در این حالت اگر طول متن بیشتر از 100 کاراکتر باشد، متن کوتاه می‌شود و در غیر این صورت همان متن اصلی نمایش داده خواهد شد.

خطای رایج هنگام استفاده از Substring

یکی از نکات مهم در استفاده از Substring، توجه به محدوده رشته است.
برای مثال کد زیر را در نظر بگیرید:

string text = "Hello";
string result = text.Substring(0, 10);

این کد با خطا مواجه خواهد شد؛ زیرا رشته فقط 5 کاراکتر دارد اما ما درخواست استخراج 10 کاراکتر را داده‌ایم.
برای جلوگیری از این مشکل بهتر است قبل از استفاده از Substring، طول رشته را بررسی کنیم:

if (text.Length >= 10)
{
    string result = text.Substring(0, 10);
}

به این ترتیب احتمال بروز ArgumentOutOfRangeException کاهش پیدا می‌کند.

تفاوت Substring با روش‌های دیگر کار با رشته

در #C روش‌های مختلفی برای پردازش رشته‌ها وجود دارد.
متدهایی مانند Split، Replace، IndexOf و Remove هرکدام کاربرد خاص خود را دارند.
Substring بیشتر زمانی مناسب است که بدانیم بخشی از رشته را بر اساس موقعیت کاراکترها می‌خواهیم.
برای مثال اگر رشته زیر را داشته باشیم:

string fullName = "Ali Ahmadi";

و بدانیم نام همیشه در ابتدای رشته قرار دارد، Substring می‌تواند برای استخراج بخش مشخصی از متن مناسب باشد.
اما اگر ساختار متن متغیر باشد، استفاده ترکیبی از IndexOf و Substring یا روش‌های دیگری مانند Split می‌تواند انتخاب بهتری باشد.

استفاده از IndexOf و Substring در سی شارپ

یکی از کاربردهای حرفه‌ای Substring، استفاده از آن در کنار IndexOf است.
فرض کنید یک ایمیل داریم:

string email = "user@example.com";

اگر بخواهیم نام کاربر را قبل از علامت @ دریافت کنیم، می‌توانیم از کد زیر استفاده کنیم:

int index = email.IndexOf('@');
string username = email.Substring(0, index);
Console.WriteLine(username);

خروجی:

user

این روش در پردازش اطلاعات کاربران، فرم‌های ثبت‌نام و داده‌های متنی کاربرد زیادی دارد.

نکات مهم هنگام استفاده از Substring در سی شارپ

• هنگام استفاده از Substring بهتر است چند نکته را همیشه در نظر داشته باشید.
• اول اینکه startIndex نباید از محدوده معتبر رشته خارج شود.
• دوم اینکه مجموع startIndex و length نباید بیشتر از طول رشته باشد.
• سوم اینکه اگر اطلاعات از کاربر، فایل یا API دریافت می‌شود، بهتر است قبل از استفاده از Substring اعتبار داده‌ها بررسی شود.
• همچنین اگر هدف شما فقط کوتاه کردن متن است، بررسی Length قبل از اجرای Substring می‌تواند از بسیاری از خطاهای زمان اجرا جلوگیری کند.

Substring در نسخه‌های جدید #C

در نسخه‌های جدیدتر .NET، امکانات دیگری برای کار با رشته‌ها نیز در اختیار برنامه‌نویسان قرار گرفته است.
با این حال، Substring همچنان یکی از متدهای ساده و پرکاربرد کلاس String محسوب می‌شود و دانستن نحوه استفاده صحیح از آن برای هر برنامه‌نویس #C ضروری است.
اگر با پروژه‌های ASP.NET Core، Windows Forms، WPF، Web API یا سایر فناوری‌های مبتنی بر دات‌نت کار می‌کنید، احتمالاً در بسیاری از بخش‌های پروژه به پردازش رشته‌ها نیاز خواهید داشت.

جمع‌بندی

متد Substring در سی‌شارپ یکی از ابزارهای مهم برای استخراج بخشی از یک رشته است.
با استفاده از این متد می‌توان از یک موقعیت مشخص تا انتهای متن یا تعداد مشخصی از کاراکترها را استخراج کرد.
ساختار ساده Substring باعث شده است که این متد در بسیاری از پروژه‌های #C مورد استفاده قرار گیرد؛ از کوتاه کردن توضیحات محصولات گرفته تا پردازش ایمیل، کدهای شناسایی، اطلاعات کاربران و داده‌های دریافتی از API.
مهم‌ترین نکته هنگام استفاده از Substring، توجه به محدوده رشته و جلوگیری از دسترسی به موقعیت‌های خارج از محدوده است.
با بررسی طول رشته و استفاده صحیح از startIndex و length می‌توان از خطاهای رایج جلوگیری کرد.
یادگیری متدهایی مانند Substring، Split، Replace، IndexOf و Contains می‌تواند مهارت شما را در پردازش داده‌های متنی به شکل قابل توجهی افزایش دهد.