精华内容
下载资源
问答
  • C++ 变量名命名规则
    2022-02-23 11:49:45

    C++提倡有一定含义的变量名。

    如果变量表示差旅费,应将其命名为cost_of_trip或costOfTrip,而不是将其命名为x或cot.

    必须遵循几种简单的C++命名规则:

    1.在名称中只能使用字母字符、数字和下划线(_)

    2.名称的第一个字符不能是数字

    3.区分大写字符与小写字符

    4.不能将C++关键字用作名称

    5.以两个下划线或下划线和大写字母打头的名称被保留给实现(编译器及其使用的资源)使用。以一个下划线开头的名称被保留给实现,用作全局标识符。

    6.C++对于名称的长度没有限制,名称中所有的字符都有意义,但有些平台有长度限制。

    note:第5点与前面几点有所不同,因为使用像_time_stop或_Donut这样的名称不会导致编译器错误,而回导致行为的不确定性。换句话说,不知道结果将是社么。不出现编译器错误的原因是,这样的名称不是非法的,但要留给实现使用。全局名称指的是名称被声明的位置。

    有效的命名:

    在变量名中加入其他的信息,即描述变量类型或内容的前缀。

    例如,将整型变量myWeight命名为nMyWeight,其中前缀n用来表示整数值

    str或sz表示以空字符结束的字符串

    b表示布尔值

    p表示指针

    c表示单个字符

    更多相关内容
  • java变量名命名规则

    2021-12-20 11:00:19
    最发现很多初级程序员写代码时很不规范,比如方法 类名 等。下面分享一篇不错的规范文章 在本文中,将从大到小,从外到内,总结Java编程中的命名规范。文中将会涉及到日常工作中常见的命名示例,如包命名,类命名...

    最发现很多初级程序员写代码时很不规范,比如方法名 类名 等。下面分享一篇不错的规范文章

    在本文中,将从大到小,从外到内,总结Java编程中的命名规范。文中将会涉及到日常工作中常见的命名示例,如包命名,类命名,接口命名,方法命名,变量命名,常类命名,抽象类命名,异常类命名以及扩展类命名等。我将按照项目工程目录结构,从包,类(接口,抽象类,异常类),方法,变量和常量的顺序展开介绍。

    本文是 Java 命名规范的介绍,建议收藏转发。

    1. 包命名规范

    包(Package)的作用是将功能相似或相关的类或者接口进行分组管理,便于类的定位和查找,同时也可以使用包来避免类名的冲突和访问控制,使代码更容易维护。通常,包名使用小写英文字母进行命名,并使用“.”进行分割,每个被分割的单元只能包含一个名词。

    一般地,包命名常采用顶级域名作为前缀,例如com,net,org,edu,gov,cn,io等,随后紧跟公司/组织/个人名称以及功能模块名称。下面是一些包命名示例:

    package org.springframework.boot.autoconfigure.cloud
    package org.springframework.boot.util
    package org.hibernate.action
    package org.hibernate.cfg
    package com.alibaba.druid
    package com.alibaba.druid.filter
    package com.alibaba.nacos.client.config
    package com.ramostear.blog.web

    下面是Oracle Java的一些常见包命名例子:

    package java.beans
    package java.io
    package java.lang
    package java.net
    package java.util
    package javax.annotation

    2. 类命名规范

    类(Class)通常采用名词进行命名,且首字母大写,如果一个类名包含两个以上名词,建议使用驼峰命名(Camel-Case)法书写类名,每个名词首字母也应该大写。一般地,类名的书写尽量使其保持简单和描述的完整性,因此在书写类名时不建议使用缩写(一些约定俗成的命名除外。

    例如 Internationalization and Localization 缩写成i18n,Uniform Resource Identifier缩写成URI,Data Access Object缩写成DAO,JSON Web Token缩写成JWT,HyperText Markup Language缩写成HTML等等)。下列是一些常见的类命名示例:

    public class UserDTO{
    
    }
    class EmployeeService{
    
    }
    class StudentDAO{
    
    }
    class OrderItemEntity{
    
    }
    public class UserServiceImpl{
    
    }
    public class OrderItemController{
    
    }

    下面是 Oracle Java 中的一些标准命名示例:

    public class HTMLEditorKit{
    
    }
    public abstract class HttpContext{
    
    }
    public interface ImageObserver{
    
    }
    public class ArrayIndexOutOfBoundsException{
    
    }
    public class enum Thread.State{
    
    }

    2.1 接口命名规范

    首先,接口(Interface)是一种表述某一类型对象动作的特殊类;简单来说,接口也是类(不太严谨),所以,接口的名称的书写也应该符合类名书写规范,首字母应该大写,与普通类名不同的是,接口命名时通常采用形容词或动词来描述接口的动作行为。下列是Oracle Java中一些标准库的接口使用形容词命名示例:

    public interface Closeable{
    
    }
    public interface Cloneable{
    
    }
    public interface Runnable{
    
    }
    public interface Comparable<T>{
    
    }
    public interface CompletionService<V>{
    
    }
    public interface Iterable<T>{
    
    }
    public interface EventListener{
    
    }

    在Spring Framework标准库中,通常采用名词+动词/形容词的组合方式来命名接口,下列是Spring Framework中一些接口命名示例:

    public interface AfterAdvice{
    
    }
    public interface TargetClassAware{
    
    }
    public interface ApplicationContextAware{
    
    }
    public interface MessageSourceResolvable{
    
    }

    2.2 抽象类命名规范

    抽象类(Abstract Class)是一种特殊的类,其命名与普通类的命名规范相当。一般地,为了将抽象类与普通类和接口做出区别,提高抽象类的可读性,在命名抽象类时,会以“Abstract”/“Base”作为类名的前缀。下面是编程中一些常规的命名示例:

    public abstract class AbstractRepository<T>{
    
    }
    public abstract class AbstractController{
    
    }
    public abstract class BaseDao<T,ID>{
    
    }
    public abstract class AbstractCommonService<T>{
    
    }

    以下是Spring Framework中常见的抽象类示例:

    public abstract class AbstractAspectJAdvice{
    
    }
    public abstract class AbstractSingletonProxyFactoryBean{
    
    }
    public abstract class AbstractBeanFactoryPointcutAdvisor{
    
    }
    public abstract class AbstractCachingConfiguration{
    
    }
    public abstract class AbstractContextLoaderInitializer{
    
    }

    2.3 异常类命名规范

    异常类(Exception Class)也是类的一种,但与普通类命名不同的是,异常类在命名时需要使用“Exception”作为其后缀。下面是常见的异常类命名示例:

    public class FileNotFoundException{
    
    }
    public class UserAlreadyExistException{
    
    }
    public class TransactionException{
    
    }
    public class ClassNotFoundException{
    
    }
    public class IllegalArgumentException{
    
    }
    public class IndexOutOfBoundsException{
    
    }

    另外,在Java中还有另外一类异常类,它们属于系统异常,这一类异常类的命名使用“Error”作为其后缀,以区分Exception(编码,环境,操作等异常)。下面是系统异常(非检查异常)的命名示例:

    public abstract class VirtualMachineError{
    
    }
    public class StackOverflowError{
    
    }
    public class OutOfMemoryError{
    
    }
    public class IllegalAccessError{
    
    }
    public class NoClassDefFoundError{
    
    }
    public class NoSuchFieldError{
    
    }
    public class NoSuchMethodError{
    
    }

    3.方法命名规范

    方法(Method)命名时,其首字母应该小写,如果方法签名由多个单词组成,则从第二个单词起,使用驼峰命名法进行书写。一般地,在对方法进行命名时,通常采用动词/动词+名词的组合,下面是方法命名的一些常见示例。

    3.1 表述获取

    如果一个方法用于获取某个值,通常使用“get”作为其前缀,例如:

    public String getUserName(){
    
    }
    public List<Integer> getUserIds(){
    
    }
    public User getOne(){
    
    }

    3.2 表述查询

    如果方法需要通过查询或筛选的方式获取某个数据,通常使用“find”/“query”作为其前缀,例如:

    public List<User> findOne(Integer id){
    
    }
    public List<Integer> findAll(){
    
    }
    public List<String> queryOrders(){
    
    }

    3.3 表述条件

    如果一个方法需要一些条件参数,则可以使用“by”/“with”等字符作为方法名中条件的连接符,例如:

    public User findByUsername(String username){
    
    }
    public List<Integer> getUserIdsWithState(boolean state){
    
    }
    public List<User> findAllByUsernameOrderByIdDesc(String username){
    
    }

    3.4 表述设置

    如果一个方法是要设置,插入,修改,删除等操作,应该将对应的动词(set,insert,update,delete)作为其名词的前缀,例如:

    public void setName(String name){
    
    }
    public User insert(User user){
    
    }
    public void update(User user){
    
    }
    public void clearAll(){
    
    }

    3.5 其他规范

    如果一个方法用于获取某组数据的长度或数量,则该方法应该使用length或size命名;如果方法的返回值为布尔类型(Boolean),则该方法应该使用“is”或”has”作为前缀;

    如果方法用于将一种类型的数据转换为另一种数据数类型,则可以使用“to”作为前缀。

    下面是综合示例:

    public long length(){
    
    }
    public int size(){
    
    }
    public boolean isOpen(){
    
    }
    public boolean isNotEmpty(){
    
    }
    public boolean hasLength(){
    
    }
    public Set<Integer> mapToSet(Map map){
    
    }
    public UserDto convertTo(User user){
    
    }
    public String toString(Object obj){
    
    }

    4. 变量命名规范

    变量(Variable)命名包括参数名称,成员变量和局部变量。变量命名通常以小写字母开头,如果变量名由多个单词构成,则从第二个单词起首字母需要大写,在变量命名过程中,不建议使用“_”作为前缀或者单词之间的分割符号。下面是一些常见的变量命名示例:

    private String nickName;
    private String mobileNumber;
    private Long id;
    private String username;
    private Long orderId;
    private Long orderItemId;

    5. 常量命名规范

    一般地,常量名称采用全部大写的英文单词书写,如果常量名称由多个单词组成,则单词之间统一使用“_”进行分割,下面是常量命名示例:

    public static final String LOGIN_USER_SESSION_KEY = "current_login_user";
    public static final int MAX_AGE_VALUE = 120;
    public static final int DEFAULT_PAGE_NO = 1;
    public static final long MAX_PAGE_SIZE = 1000;
    public static final boolean HAS_LICENSE = false;
    public static final boolean IS_CHECKED = false;

    6. 枚举命名规范

    枚举(Enum)类是一种特殊的类,其命名规范遵循普通类的命名约束条件,首字母大写,采用驼峰命名法;枚举类中定义的值的名称遵循常量的命名规范,且枚举值的名称需要与类名有一定的关联性,下面是枚举的一些示例:

    public enum Color{
        RED,YELLOW,BLUE,GREEN,WHITE;
    }
    public enum PhysicalSize{
        TINY,SMALL,MEDIUM,LARGE,HUGE,GIGANTIC;
    }

    下面是Oracle Java标准库中的一个示例:

    public enum ElementType{
        TYPE,
        FIELD,
        METHOD,
        PARAMETER,
        CONSTRUCTOR,
        LOCAL_VARIABLE,
        ANNOTATION_TYPE,
        PACKAGE,
        TYPE_PARAMETER,
        TYPE_USE;
    }

    7. 其他命名规范

    7.1 数组

    在定义数组时,为了便于阅读,尽量保持以下的书写规范:

    int[] array = new int[10];
    int[] idArray ={1,2,3,4,5};
    String[] nameArray = {"First","Yellow","Big"}
    
    public List<String> getNameById(Integer[] ids){
    
    }
    
    public List<String> getNameById(Integer...ids){
    
    }

    7.2 表述复数或者集合

    如果一个变量用于描述多个数据时,尽量使用单词的复数形式进行书写,例如:

    Collection<Order> orders;
    int[] values;
    List<Item> items;

    另外,如果表述的是一个Map数据,则应使用“map”作为其后缀,例如:

    Map<String,User> userMap;
    Map<String,List<Object>> listMap;

    7.3 泛型类

    在书写泛型类时,通常做以下的约定:

    • E表示Element,通常用在集合中;
    • ID用于表示对象的唯一标识符类型
    • T表示Type(类型),通常指代类;
    • K表示Key(键),通常用于Map中;
    • V表示Value(值),通常用于Map中,与K结对出现;
    • N表示Number,通常用于表示数值类型;
    • ?表示不确定的Java类型;
    • X用于表示异常;
    • U,S表示任意的类型。

    下面是泛型类的书写示例:

    public class HashSet<E> extends AbstractSet<E>{
    
    }
    public class HashMap<K,V> extends AbstractMap<K,V>{
    
    }
    public class ThreadLocal<T>{
    
    }
    public interface Functor<T,X extends Throwable>{
        T val() throws X;
    }
    public class Container<K,V>{
        private K key;
        private V value;
        Container(K key,V value){
            this.key = key;
            this.value = value;
        }
    
    }
    
    public interface BaseRepository<T,ID>{
        T findById(ID id);
    
        void update(T t);
    
        List<T> findByIds(ID...ids);
    }
    
    public static <T> List<T> methodName(Class<T> clz){
        List<T> dataList = getByClz(clz);
        return dataList;
    }

    7.4 接口实现类

    为了便于阅读,在通常情况下,建议接口实现类使用“Impl作为后缀”,不建议使用大写的“I”作为接口前缀,下面是接口和接口实现类的书写示例。

    推荐写法:

    public interface OrderService{
    
    }
    public class OrderServiceImpl implements OrderService{
    
    }

    不建议的写法:

    public interface IOrderService{
    
    }
    public class OrderService implements IOrderService{
    
    }

    7.5 测试类和测试方法

    在项目中,测试类采用被测试业务模块名/被测试接口/被测试类+“Test”的方法进行书写,测试类中的测试函数采用“test”+用例操作_状态的组合方式进行书写,例如:

    public class UserServiceTest{
    
        public void testFindByUsernameAndPassword(){
    
        }
    
        public void testUsernameExist_notExist(){
    
        }
    
        public void testDeleteById_isOk(){
    
        }
    }
    展开全文
  • 单片机程序命名规范,C语言命名规范和关键字。单片机程序命名规范,C语言命名规范和关键字。单片机程序命名规范,C语言命名规范和关键字。
  • C语言变量名命名规则

    2015-08-13 22:44:54
    C语言变量名命名规则 一、程序风格: 1、严格采用阶梯层次组织程序代码: 各层次缩进的分格采用VC的缺省风格,即每层次缩进为4格,括号位于下一行。 要求相匹配的大括号在同一列,对继行则要求再缩进4格。例如: 2、...
  • C语言变量名命名规则一、程序风格:1、严格采用阶梯层次组织程序代码:各层次缩进的分格采用VC 的缺省风格,即每层次缩进为4格,括号位于下一行。要求相匹配的大括号在同一列,对继行则要求再缩进4格。例如:2、提示...

    C语言变量名命名规则

    一、程序风格:

    1、严格采用阶梯层次组织程序代码:

    各层次缩进的分格采用VC 的缺省风格,即每层次缩进为4格,括号位于

    下一行。

    要求相匹配的大括号在同一列,对继行则要求再缩进4格。例

    如:

    2、提示信息字符串的位置

    在程序中需要给出的提示字符串,为了支持多种语言的开发,除了一些

    给调试用的临时信息外,其他所有的提示信息必须定义在资源中。

    3、对变量的定义,尽量位于函数的开始位置。

    二、命名规则:

    1、变量名的命名规则

    ①、变量的命名规则要求用 “匈牙利法则”。即开头字母用变量的类型,

    其余部分用变量的英文意思或其英文意思的缩写,尽量避免用中文的拼音,要求

    单词的第一个字母应大写。

    即: 变量名 变量类型+变量的英文意思 (或缩写)

    对非通用的变量,在定义时加入注释说明,变量定义尽量可能放在函数

    的开始处。

    见下表:

    变量类型 前缀 实例 备注

    位域 bit bitRXEN 寄存器控制接收使能的位

    Bool b bTurnOn

    Unsigned Char uc ucError

    Char c cName

    Unsigned Short w wMsg

    Short n nCnt

    Unsigned Int u uiLen

    Int i iVal

    Unsigned Long ul ulMaxTh

    Long l LOffset

    Long Int li liCount

    Long Long ll llSum

    Float f fAngle

    Double d dRadius

    Enum e eType

    一级指针 p_ p_iVal

    二级指针 pp_ pp_iVal

    一维数组 a_ a_chDispName[]

    二维数组 aa_ aa_chPrtName[][]

    函数 fn void fnProc(void) 申明函数类型,该函数形参

    和返回值均为void

    函数指针 pfn pfnFlashWrite 保存函数入口地址的指针

    变量

    回调函数指针 lpfn lpfnAbort 系统终止时调用该函数

    结构体 st stTimeNode “时间节点”的结构体

    局部变量 l_ l_iCount 仅供本例程调用的变量

    静态变量 s_ s_pQData 仅供本模块调用的“队列缓

    冲区”的指针

    全局变量 g_ g_pSemBtn 供多个模块调用的 “按钮

    展开全文
  • C语言变量名命名规则[整理].pdf
  • python的变量命名规范

    千次阅读 2020-11-21 01:53:53
    一.python变量名命名规则:1.变量名通常由字母,数字,下划线组成;2.数字不能作为变量名开头;3.不能以python中的关键字命名;4.变量名要有意义;5.不要用汉字和拼音去命名;6.变量名要区分大小写;7.推荐使用驼峰型...

    一.python变量名命名规则:

    1.变量名通常由字母,数字,下划线组成;

    2.数字不能作为变量名开头;

    3.不能以python中的关键字命名;

    4.变量名要有意义;

    5.不要用汉字和拼音去命名;

    6.变量名要区分大小写;

    7.推荐使用驼峰型(GuessAge或guessAge)和下划线(guess_age)来命名;

    8.常量通常使用大写来定义.

    二.注释代码的方法

    1.单行(当行)注释:用#

    1497368-20181022215251954-1108084212.png

    2.多行注释通过三引号完成

    1497368-20181022215407891-2062617863.png

    三.python中的初始基础数据类型

    1.整型int:主要用于计算和比较,可以进行加,减,乘,除的运算;

    1497368-20181022220035730-1661372795.png

    2.字符串str

    + 必须是两个字符串

    * 只能字符串和数字相乘

    3.布尔值

    返回True或者False

    四.程序交互

    可通过input()来进行程序的交互,需要注意括号里的内容必须是字符串,或者叫提示语句,并且input中获取的信息也是字符串格式.

    可通过type()来查看数据的类型,括号中放入要查看的数据.

    五.格式化输出

    1.可通过占位符来完成%,%s字符串占位(注意s小写),%d(%i)整型占位

    注意:必须按照对应的数量来填充,根据使用位置填充

    1497368-20181022224801378-1800090389.png

    2.通过使用f来实现

    1497368-20181022225701289-498475250.png

    ---恢复内容结束---

    展开全文
  • Java中的变量名命名规则

    万次阅读 2018-09-09 18:58:17
    变量命名规则: 1.变量名必须是以字母、数字、下划线或组成2.变量名首字符必须为字母(a−zA−Z),下划线(),或者美元符号(组成2.变量名首字符必须为字母(a−zA−Z),下划线(),或者美元符号(组成 2.变量名首字符...
  • 下面小编就为大家带来一篇谈谈变量命名规范的重要性。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
  • python变量名命名规则

    千次阅读 2020-11-20 20:14:51
    原博文2020-03-21 11:07 −一.python变量名命名规则:1.变量名通常由字母,数字,下划线组成;2.数字不能作为变量名开头;3.不能以python中的关键字命名;4.变量名要有意义;5.不要用汉字和拼音去命名;6.变量名要区分大小写...
  • python变量名命名规则 变量名是指在代码中自定义的变量参数,比如a,b,_h, h1等,都可以称为变量名。下面介绍变量名的命名规范: 变量名第一个字符必须是字母表中字母或下划线 _ ; 变量名可以由字母、数字和下划线...
  • python中的变量命名规则

    千次阅读 2022-03-12 13:39:11
    There are only two hard things in Computer Science: cache ...python中的变量命名规则1.变量命名2. 变量命名的描述性3.变量名尽量短,但是不要太短4.合理使用变量5. 变量定义尽量靠近使用6. 合理使用namedtuple/
  • Java中变量名命名的一些规定和规范

    千次阅读 2019-05-11 14:37:08
    一、变量名命名的一些规定:1.必须以字母、下划线、或者美元符$开头;①以美元符$ 开头命名的变量虽然能够编译通过但是不建议使用; ②中文也可以作为命名开头且编译也能通过,但是不建议使用。2.除开头外后面的部分...
  • Java变量命名规范

    2021-07-11 20:51:59
    注意:[]里面的内容代表可以不写,变量名命名要符合规范,类型可以是基础类型,也可以是引用类型,或者自定义的引用类型。每一条语句写完,必须要有分号结尾。 public class demo1 { public static void main...
  • 变量命名还应遵守以下某条著名的命名规则: 著名的变量命名规则Camel 标记法首字母是小写的,接下来的字母都以大写字符开头。例如: 代码如下:var testValue = 0, secondValue = “hi”;Pascal 标记法首字母是大写的...
  • java变量命名规范

    千次阅读 2018-12-08 22:36:00
    1.java变量命名规则: 1以下划线、字母、美元符开头 2后面跟下划线、字母、美元符以及数字。 命名规范 Package(包)的命名: Package的名字应该都是由一个小写单词组成,例如net.ebseries.modules。 (二)Class...
  • Js变量名命名规范

    2021-12-05 22:14:33
    Js变量名命名规范
  • 1. js变量名可以包含数字,字母,$及_,不能以数字开头。 2. js变量可以使用中文,但是最好不要这么命名,以避免不必要的麻烦。 转载于:https://www.cnblogs.com/lqw007/p/9593008.html...
  • 变量命名规则和命名规范

    千次阅读 2020-05-22 16:31:34
    变量命名规则和命名规范 规则:(必须遵守的,不遵守就是错) 1.一个变量名称可以由数字、字母、下划线、美元符号($) 组成 2.严格区分大小写 3.不能由数字开头,不要使用中文汉字命名 4.不能是保留字或者关键字 5....
  • PHP变量命名

    2021-04-24 18:10:27
    PHP变量命名PHP 变量命名变量命名分为普通变量、静态变量、局部变量、全局变量、Session变量等方面的命名规则。1) 普通变量普通变量命名遵循以下规则:a. 所有字母都使用小写;b. 对于一个变量使用多个单词的,...
  • C#基础学习(五) | 变量命名规则
  • Python变量命名规则

    千次阅读 2021-06-14 09:08:04
    在Python中使用变量时,需要遵守一些规则和指南。违反这些规则将引发错误,而指南旨在让你编写的代码更...例如,变量名greeting_message 可行,但变量名greeting message 会引发错误。 不要将Python关键字和函数名.
  • 2015-04-29 06:30:02阅读( 82 )一般规则:【规则1-1】命名应当直观且可以拼读,可望文知意,便于记忆和阅读。标识符最好采用英文单词或其组合,不允许使用拼音。程序中的英文单词一般不要太复杂,...例如变量名Max...
  • js变量命名规范

    2021-06-30 14:12:57
    最近对于ES6中变量命名关于变量是不是应该大写,特意再重新梳理了一遍基础,特总结如下...当变量名是由两个或多个单词构成时,可以采用驼峰命名法。 驼峰命名有两种形式: 小驼峰式命名法(lower camel case):第一个.
  • Java变量命名规范

    万次阅读 2019-03-31 11:48:50
    Java是一种区分字母大小的语言,因此我们在定义变量的时候应该注意区分大小写的使用和一些规范,下面简单的讲讲。 (一)Package(包)的命名 1、package命名要求包含的所有字符均为小写,同时不能有特殊字符。 2、...

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 320,421
精华内容 128,168
关键字:

变量名的命名规则

友情链接: CLOCK_FINAL.rar