دوال النصوص (String Functions)

-- MySQL/PostgreSQL
CONCAT(string1, string2, string3, ...)

-- SQL Server
string1 + string2 + string3

-- أو استخدم CONCAT في SQL Server أيضاً
CONCAT(string1, string2, string3, ...)

+----+------------+-----------+--------+
| id | first_name | last_name | salary |
+----+------------+-----------+--------+
| 1  | أحمد       | محمد      | 5000   |
| 2  | فاطمة      | علي       | 6000   |
| 3  | سارة       | خالد      | 7000   |
+----+------------+-----------+--------+

SELECT 
    id,
    CONCAT(first_name, ' ', last_name) AS full_name,
    salary
FROM employees;

+----+---------------+--------+
| id | full_name     | salary |
+----+---------------+--------+
| 1  | أحمد محمد     | 5000   |
| 2  | فاطمة علي     | 6000   |
| 3  | سارة خالد     | 7000   |
+----+---------------+--------+

SELECT 
    CONCAT('مرحباً ', first_name, '! راتبك الحالي هو ', salary, ' ريال') AS welcome_message
FROM employees;

+------------------------------------------------+
| welcome_message                                |
+------------------------------------------------+
| مرحباً أحمد! راتبك الحالي هو 5000 ريال        |
| مرحباً فاطمة! راتبك الحالي هو 6000 ريال       |
| مرحباً سارة! راتبك الحالي هو 7000 ريال        |
+------------------------------------------------+

-- CONCAT_WS = CONCAT With Separator
SELECT 
    CONCAT_WS(' - ', first_name, last_name, salary) AS employee_info
FROM employees;

+------------------------+
| employee_info          |
+------------------------+
| أحمد - محمد - 5000     |
| فاطمة - علي - 6000     |
| سارة - خالد - 7000     |
+------------------------+

-- MySQL/PostgreSQL/SQL Server
SUBSTRING(string, start_position, length)

-- أو
SUBSTR(string, start_position, length)

-- ملاحظة: الموضع يبدأ من 1 في SQL

+----+--------------+-------+
| id | product_code | price |
+----+--------------+-------+
| 1  | LAP-2024-001 | 3500  |
| 2  | MOU-2024-002 | 50    |
| 3  | SCR-2024-003 | 800   |
+----+--------------+-------+

SELECT 
    product_code,
    SUBSTRING(product_code, 1, 3) AS category,
    SUBSTRING(product_code, 5, 4) AS year,
    SUBSTRING(product_code, 10, 3) AS serial
FROM products;

+--------------+----------+------+--------+
| product_code | category | year | serial |
+--------------+----------+------+--------+
| LAP-2024-001 | LAP      | 2024 | 001    |
| MOU-2024-002 | MOU      | 2024 | 002    |
| SCR-2024-003 | SCR      | 2024 | 003    |
+--------------+----------+------+--------+

SELECT 
    email,
    SUBSTRING(email, POSITION('@' IN email) + 1) AS domain
FROM users;

UPPER(string)  -- تحويل إلى أحرف كبيرة في SQL
LOWER(string)  -- تحويل إلى أحرف صغيرة في SQL

+----+-------------------+
| id | email             |
+----+-------------------+
| 1  | Ahmed@Gmail.com   |
| 2  | FATIMA@yahoo.com  |
| 3  | sara@Outlook.COM  |
+----+-------------------+

SELECT 
    email AS original,
    UPPER(email) AS uppercase,
    LOWER(email) AS lowercase
FROM users;

+-------------------+-------------------+-------------------+
| original          | uppercase         | lowercase         |
+-------------------+-------------------+-------------------+
| Ahmed@Gmail.com   | AHMED@GMAIL.COM   | ahmed@gmail.com   |
| FATIMA@yahoo.com  | FATIMA@YAHOO.COM  | fatima@yahoo.com  |
| sara@Outlook.COM  | SARA@OUTLOOK.COM  | sara@outlook.com  |
+-------------------+-------------------+-------------------+

-- البحث عن جميع رسائل Gmail بغض النظر عن الحالة
SELECT *
FROM users
WHERE LOWER(email) LIKE '%gmail.com';

TRIM(string)           -- إزالة المسافات من الطرفين في SQL
LTRIM(string)          -- إزالة المسافات من اليسار في SQL
RTRIM(string)          -- إزالة المسافات من اليمين في SQL
TRIM(BOTH ' ' FROM string)  -- إزالة حرف معين من الطرفين

+----+------------------+
| id | name             |
+----+------------------+
| 1  | '  أحمد  '       |
| 2  | 'فاطمة   '       |
| 3  | '   سارة'        |
+----+------------------+

SELECT 
    name AS original,
    TRIM(name) AS trimmed,
    LENGTH(name) AS original_length,
    LENGTH(TRIM(name)) AS trimmed_length
FROM users;

+------------+---------+-----------------+-----------------+
| original   | trimmed | original_length | trimmed_length  |
+------------+---------+-----------------+-----------------+
| '  أحمد  ' | 'أحمد'  | 8               | 4               |
| 'فاطمة   ' | 'فاطمة' | 9               | 5               |
| '   سارة'  | 'سارة'  | 7               | 4               |
+------------+---------+-----------------+-----------------+

-- MySQL/PostgreSQL
LENGTH(string)

-- SQL Server
LEN(string)

SELECT 
    username,
    password,
    LENGTH(password) AS password_length,
    CASE 
        WHEN LENGTH(password) < 8 THEN 'ضعيفة'
        WHEN LENGTH(password) BETWEEN 8 AND 12 THEN 'متوسطة'
        ELSE 'قوية'
    END AS password_strength
FROM users;

-- البحث عن الأسماء التي طولها أقل من 5 أحرف
SELECT name, LENGTH(name) AS name_length
FROM employees
WHERE LENGTH(name) < 5;

REPLACE(string, old_substring, new_substring)

SELECT 
    phone,
    REPLACE(phone, '-', '') AS phone_clean,
    REPLACE(phone, '05', '+9665') AS phone_international
FROM customers;

+--------------+-------------+---------------------+
| phone        | phone_clean | phone_international |
+--------------+-------------+---------------------+
| 055-123-4567 | 0551234567  | +96655-123-4567     |
| 050-987-6543 | 0509876543  | +96650-987-6543     |
+--------------+-------------+---------------------+

SELECT 
    name,
    CONCAT(
        SUBSTRING(phone, 1, 3),
        '-***-',
        SUBSTRING(phone, -4)
    ) AS masked_phone
FROM customers;

-- استخراج أول N حرف من اليسار في SQL
SELECT LEFT('Hello World', 5);  -- النتيجة: 'Hello'

-- استخراج آخر N حرف من اليمين في SQL
SELECT RIGHT('Hello World', 5);  -- النتيجة: 'World'

-- عكس النص في SQL
SELECT REVERSE('Hello');  -- النتيجة: 'olleH'

-- تكرار نص في SQL
SELECT REPEAT('*', 5);  -- النتيجة: '*****'

-- مثال عملي: إنشاء خط فاصل
SELECT CONCAT(name, ' ', REPEAT('-', 20)) AS separator
FROM employees;

-- البحث عن موضع نص في SQL
SELECT POSITION('World' IN 'Hello World');  -- النتيجة: 7

-- أو استخدم LOCATE في MySQL
SELECT LOCATE('World', 'Hello World');  -- النتيجة: 7

SELECT 
    CONCAT(
        UPPER(LEFT(first_name, 1)),
        LOWER(SUBSTRING(first_name, 2)),
        ' ',
        UPPER(LEFT(last_name, 1)),
        LOWER(SUBSTRING(last_name, 2))
    ) AS formatted_name
FROM customers;

SELECT 
    email,
    SUBSTRING(email, 1, POSITION('@' IN email) - 1) AS username,
    SUBSTRING(email, POSITION('@' IN email) + 1) AS domain,
    CASE 
        WHEN LOWER(email) LIKE '%gmail.com' THEN 'Gmail'
        WHEN LOWER(email) LIKE '%yahoo.com' THEN 'Yahoo'
        WHEN LOWER(email) LIKE '%outlook.com' THEN 'Outlook'
        ELSE 'Other'
    END AS provider
FROM users;

SELECT 
    phone AS original,
    REPLACE(REPLACE(REPLACE(phone, '-', ''), ' ', ''), '(', '') AS cleaned,
    CONCAT(
        '+966',
        SUBSTRING(REPLACE(REPLACE(phone, '-', ''), ' ', ''), 2)
    ) AS international
FROM customers;

SELECT 
    first_name,
    last_name,
    LOWER(CONCAT(
        LEFT(first_name, 1),
        last_name,
        SUBSTRING(CAST(id AS CHAR), -3)
    )) AS auto_username
FROM employees;

SELECT 
    CONCAT(UPPER(first_name), ' ', UPPER(last_name)) AS full_name,
    LOWER(TRIM(email)) AS email_clean,
    CONCAT(
        'العميل: ', first_name, 
        ' | البريد: ', SUBSTRING(email, 1, 20),
        ' | الهاتف: ', REPLACE(phone, '-', '')
    ) AS customer_summary,
    LENGTH(CONCAT(first_name, last_name)) AS name_length
FROM customers
WHERE LENGTH(TRIM(email)) > 0;

-- سيء: قد تفشل المقارنة بسبب المسافات
WHERE name = 'أحمد'

-- جيد: إزالة المسافات قبل المقارنة في SQL
WHERE TRIM(name) = 'أحمد'

-- سيء: إذا كان middle_name هو NULL، النتيجة NULL
CONCAT(first_name, ' ', middle_name, ' ', last_name)

-- جيد: استخدام COALESCE في SQL
CONCAT(first_name, ' ', COALESCE(middle_name, ''), ' ', last_name)