Чому більшість полів (учасників класу) в підручнику для Android починаються з `m`?

Я знаю про правила справи з верблюдами, але я плутаю це правило. Що це означає? Я розробник PHP. "Ми" використовуємо перші літери змінних як вказівку типу, наприклад, "b" для булевих, "i" для цілих чисел тощо.

Це "я" річ Java? Чи означає це мобільний телефон? змішаний?

Ця позначення походить з правил керівництва стилем коду AOSP (Android Open Source) для учасників :

Дотримуйтесь конвенцій про іменування поля

• Непублічні, нестатичні назви полів починаються з m.
• Назви статичних полів починаються з s.
• Інші поля починаються з малої літери.
• Публічні статичні кінцеві поля (константи) - ALL_CAPS_WITH_UNDERSCORES.

Зауважте, що пов’язаний посібник зі стилем призначений для внесення коду до проекту з відкритим кодом Android.

Це не посібник зі стилем для коду окремих програм для Android.

Дуже багато керівних ліній кодування використовують m для 'членів' класу. Отже, коли ви програмуєте, ви можете бачити різницю між локальними та членами змінних.

Що таке mпрефікс?

mпозначає змінну члена або член даних. Використовуйте mпрефікс для непублічних та нестатичних полів.

Коли використовувати?

private String mCityName;
private float mTemperature;

Коли не користуватися?

public static int mFirstNumber;
public static final String mDATABASE_NAME;

Що я роблю?

Особисто я цим не користуюся. Це робить код складнішим і хаосує читабельність. Якщо ви все ще використовуєте Блокнот для кодування, у мене немає слів, але сучасні IDE здатні виділяти та забарвлювати членські та локальні змінні чи щось інше.

Висновок

Використовувати? "Так" або "ні" - це ваш особистий вибір.

Якщо це змінні елементи в класах, 'm' означає 'member'. Багато Java-програмісти роблять це, хоча для сучасних IDE це не потрібно, оскільки у вас є виділення, вказівник миші та підказки тощо.

Згідно книги «Чистий код», це не чистий код.

Не потрібно префіксувати змінні члена з m . Крім того, люди швидко вчаться ігнорувати префікс або суфікс, щоб побачити змістовну частину імені.

Якщо у вас є такі проблеми

ваш IDE для створення сетерів / getters, і ви отримуєте getmName () та setmName ()

Не забудьте зробити наступне ( Налаштування / Редактор / Стиль коду / Генерація Java / Коду ):

Оновлення: ми не використовуємо щось подібне в Котліні (тому краще перейти на нього і більше не використовувати префікси)

Я вважаю, що дуже індивідуально, які кодові угоди використовуються. Я вважаю за краще називати свої змінні такими префіксами:

• m - змінні методу
• c - змінні класу
• p - змінні параметра

Але я здогадуюсь, що кожен програміст має свій стиль.

Щоб довести, що ви визначено не повинні ставитися до цієї конвенції щодо іменування змінних у своєму коді, я передаю скріншот з батьківської Android Studio за цим документом.

Знайдіть, що змінні всередині об'єкта спеціально відсортовані, щоб m-змінні ставили нижче, ніж ваші нативні змінні . Отже, називаючи їх у своєму коді з префіксом «m», ви ховаєте їх у купу від себе .

Єдине перевагу, яке я знайшов у цьому стилі коду, - це коли під час автоматичного заповнення деякої посилання на змінну я знаю, що можу набрати "m", щоб побачити лише змінні учасника.

Як було сказано раніше, він призначений для різних змінних. Але також це дуже корисно для генерації коду. Якщо натиснути "Alt + Insert", ви отримаєте вікна для найбільш поширених властивостей генерації коду. Якщо ви хочете створити метод "отримати" для вашої змінної, ви отримаєте.

public class Foo{
   private int bar;

   public int getBar(){
       return this.bar;
   }

   public void setBar(int bar){
       this.bar = bar; 
   }

}

Але якщо ви оголосите "m, s", ви отримаєте:

public class Foo{
private int mBar;

public int getBar(){
   return mBar;
}

public void setBar(int bar){
   mBar = bar;
}
}

Він буде автоматично генерований та "m" або "s" видалений з вашого конструктора, отримати, встановити ім'я методів. Після цього "get" і "set" для поля будуть генеровані без "m". Andoroid Fle-> Налаштування-> Стиль коду-> Java-> Генерація коду. І зробити як на малюнку. Можливо, це допоможе. Вибачте за мою англ. Налаштувати андроїд

Здається, було особистим уподобанням деяких ранніх інженерів Android / Google запускати змінні учасники з «m», тому вони рекомендували це.

Тепер це правило змушується забивати горло розробникам у компаніях, які не є жодними учасниками AOSP, просто тому, що ця сторінка вважається правилами Android Code Style. З цього правила мало користі. Google повинен розглянути можливість її видалення. В іншому випадку вкажіть, що для програм Android, які з правил стилю коду не є обов'язковими.

Додайте свій коментар підтримки до цієї петиції, щоб видалити правило https://code.google.com/p/android/isissue/detail?id=226814

Що стосується читабельності, конвенція mщодо змінних членів та sстатичних полів більше не повинна використовуватися, якщо ви використовуєте сучасний IDE, як Android Studio. Android Studio може розрізняти ті, не додаючи mабо s.

Можна також констатувати, що воно означає "моє", як в класі / екземплярі говориться: "Ця змінна моя і ніхто більше не може дійти до неї". Відмінний від статичного, який, хоча він може бути доступний лише для Класу, ділиться всіма примірниками цього класу. Як якщо б ви малювали кола, вам потрібно було б знати, наскільки великий радіус кожного кола

    private double mRadius;

але в той же час ви хочете, щоб лічильник відстежував усі кола, усередині класу кола, який ви могли мати

    private static int sCircleCount;

а потім просто мати статичних членів, щоб збільшити і зменшити кількість кіл, які ви зараз маєте.

Нижче наведено умови іменування,

• Непублічні, нестатичні назви полів починаються з m.
• Назви статичних полів починаються з s.
• Інші поля починаються з малої літери.
• Публічні статичні кінцеві поля (константи) - ALL_CAPS_WITH_UNDERSCORES.

Приклад:

public class MyClass {
    public static final int SOME_CONSTANT = 42;
    public int publicField;
    private static MyClass sSingleton;
    int mPackagePrivate;
    private int mPrivate;
    protected int mProtected;
}